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Section 1 



INTRODUCTION 



ABOUT THE MANUAL PACKAGE 



THIS MANUAL 

ti_:_ a a a a ii~«x n_.~_.._.. 
i ins 1 1 it nusi riuyicii 

programmer who is writing a package of host computer 
subroutines to communicate with the TEKTRONIX 
4114 Computer Display Terminal (Figure 1 -1 ). This 
manual describes the 41 1 4 commands and tells how to 
issue them by sending sequences of ASCII characters 

LVS 11 IV ».»l Kill I til. 

NOTE 

This manual is intended to be used together with 
the 4110 Series Command Reference Manual, 
That manual has, in alphabetical order, descrip- 
tions of all the 4114 commands, parameter types, 
and other syntactic constructs. There you will find 
the exact syntax of each command, a description 
of the command's function, a list of error codes 
for that command, and references to other, relat- 
ed commands. 

For operator information (such as the use of SETUP 
mode), see the 41 1 4 Operator's Manual. 

Any reference in this manual to the 41 14 applies equally to 
the 41 1 4A, 41 1 4A30, 41 1 6A, and 41 1 6A30. The 41 1 4A is a 
newer version of the 41 1 4. The 41 1 6A responds to the same 
commands as the 41 14A, but uses a larger display. The 
41 1 4A30 and 41 1 6A30 are desk configurations of the 41 14A 
and4116A. 



OTHER 41 14 MANUALS 

■ nS lOnOWing rsiSiSu manuaiS may prove ussiul: 

• 41 1 4 Computer Display Terminal Operator's 
Manual. This manual is written for the terminal 
operator. Here are descriptions of all the keys and 
of the "SETUP mode" commands by which the 
operator can change terminal settings. 

• 41 1 Series Command Reference Manual. The 

Command Reference Manual contains definitive 
descriptions of all commands, parameter types, 
report messages, and other syntactic constructs. 
Once you have become acquainted with the termi- 
nal, you will use this manual more than any other. 

• Manuals for the TEKTRONIX 401 0C01 PLOT 10 
Interactive Graphics Library. The Interactive 
Graphics Library (IGL) is a package of FORTRAN 
subroutines for use in writing computer graphics 
applications programs. If IGL is available at your 
computer installation, the easiest way to control the 
terminal will be through calls to IGL subroutines. 

Service manuals are also available; however, these are 
probably not of use to the host computer programmer. 
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INTRODUCTION 



HOW TO USE THIS MANUAL 



BASIC ORGANIZATION 

The sections of this manual are arranged in approxi- 
mate order of increasing complexity. That is, later 
sections describe more complex subject matter and 
may employ concepts introduced in earlier sections. 

This manual is intended to be read in conjunction with 
the 41 1 Series Command Reference Manual. Be sure 
to have that manual close at hand; you will need it for 
descriptions of the exact syntax of the different 
commands. 

Read Section 2 of this manual before reading later 
sections, and before referring to the 41 1 Series 
Command Reference Manual. Section 2 describes the 
syntax notation used in the two manuals and describes 
the general format of 41 1 4 commands. 

Section 3 provides an overview of the graphics pro- 
gramming task. If you are already well acquainted with 
programming techniques, then you may wish to skip 
this section. Terms such as device drivers and commu- 
nications interface routines are defined, and examples 
of how to write host device driver subprograms are 
given. 

The remaining sections describe different aspects of 
the terminal, and how to perform common tasks: 
displaying alphanumeric text, displaying graphic 
information, using the terminal's local storage of pic- 
ture segments, etc. If you wish, you may skip to the 
section describing the task before you. Sooner or later, 
however, you should read through all these sections to 
become acquainted with the terminal's most important 
features. 



WHERE TO LOOK FOR INFORMATION 

If you are writing a subroutine to issue a single 
command to the terminal, see the description of that 
command in the 41 10 Series Command Reference 
Manual. There you will find the command's exact 
syntax, a description of its function, a list of possible 
errors which the terminal may detect while executing 
that command, and so on. 

If you a writing a program or subroutine to perform 
some higher-level function, see the description of that 
function in this manual. The examples in those sec- 
tions should help you decide which commands to send 
to the terminal. You will probably then call subroutines 
to issue those commands. 
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ABOUT THE 41 14 



FEATURES 

The 41 1 4 Computer Display Terminal permits the 
terminal's operator to communicate with a host compu- 
ter. Besides sending and receiving characters of text, 
the terminal can: 

• Display pictures sent from the computer or stored 
locally on its optional disk drives. 

• Store and manipulate picture segments locally 
(within itself). This relieves the host computer of the 
burden of manipulating those segments. It also 
makes more efficient use of the data communica- 
tions line between the terminal and the host 
computer. 

• Cope with imperfect data communications lines by 
means of a optional block mode communications 
protocol. 

• Create (on command from the host computer) alter- 
nate character fonts, and use these fonts to display 
alphanumeric information. 

• Define 'macros' which can be expanded on 
command. Macros numbered from to 1 43 can also 
be invoked by pressing keyboard keys; thus the 
macro facility allows the operator or the host 
computer to program alternate meanings into most 
of the terminal's keys. 

• Store picture segments and macro definitions on its 
optional disk drives, and retrieve them later to use 
again. 

ALPHA, VECTOR, AND MARKER MODES 

The 4114 has three main modes of operation: alpha 
mode, vector mode, and marker mode. There are also 
several other modes which it enters temporarily while 
executing certain commands. 

• In alpha mode, the 41 1 4 displays characters re- 
ceived from the host. This is the mode used when 
logging in on a host computer or when running non- 
graphics programs. 

• In vector mode, the 41 1 4 interprets alphanumeric 
characters coming from the host as xy coordinates 
for 'moves' and 'draws' of vectors (straight line 
segments) on the screen. 

• In marker mode, the 4114 interprets alphanumeric 
characters coming from the host as xy coordinates 
at which to display markers — small symbols. 



SEGMENTS 

The 4114 can manipulate segments (short for 'picture 
segments') and use them to build complex pictures. For 
instance, segments holding symbols for transistors, 
resistors, capacitors, etc., might be used to compose an 
electrical schematic diagram. 

The 41 1 4 can store and manipulate these segments 
locally. This relieves the host computer of some 
computations. More importantly, the 41 1 4's local seg- 
ment-handling capability drastically reduces the num- 
ber of characters which must be sent over the data 
communications line. (The communications line is the 
main 'bottleneck' inhibiting the rapid display of 
computer graphics. Graphic coordinates can be trans- 
mitted over typical communications lines only at rates 
far slower than those coordinates can be computed by 
the host computer, or displayed by the 41 1 4 terminal.) 

THE DIALOG AREA 

The operator or the computer can create a dialog area: 
a part of the screen used for conversational dialogs 
between the operator and (a) the host computer or (b) 
the terminal. Text displayed in the dialog area does not 
interfere with pictures which the terminal may also be 
displaying. 
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INTRODUCTION 



TWO KINDS OF TEXT 

The 41 1 4 can display two kinds of text: alphatext and 
graphtext. Alphatext is used primarily for dialogs 
between the operator and the computer. Graphtext is 
used only in graphic displays. 

Alphatext is the ordinary text displayed by the 41 1 4 
while it is in alpha mode. Alphatext can be displayed in 
a wide variety of character sizes. If the optional APL 
keyboard is installed, then alphatext can also be 
displayed in a alternate font for use with the APL 
programming language. Figure 1-2 shows samples of 
alphatext. 

Graphtext is text occurring within a graphic-text com- 
mand. (The graphic-text command is described in 
Section 5, and in the 41 1 Series Command Reference 
Manual.) Graphtext is used for fancy or high-quality 
lettering, especially within pictures or graphs. Graphic 
text may be displayed on the screen, or it may be 
included within the definition of a picture segment. 
However, it may not be displayed in the dialog area. 



You can display graphtext in either of two degrees of 
'precision' (text quality): stroke precision or string 
precision. Stroke precision lets you rotate the text; it 
also lets you define your own character fonts. (Stroke 
precision is the default precision for graphtext.) Graph- 
text displayed with only 'string precision' appears the 
same as alphatext. String-precision graphtext cannot 
be rotated, nor can you define your own string- 
precision text fonts. 

Figure 1-3 shows examples of graphtext. 



ABCDEFGH I JKLMNOPQRSTUVWX YZ 1 234567890 
abcdef ghi jklmTiopqrstuvwxL/z 



Figure 1 -2. Samples of Alphatext. 
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This is pre-defined graphtext font 0. 
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F'gurs 1 -3 Samples of Graphtext. 
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Section 2 



COMMAND SYNTAX 



SYNTAX NOTATION 



Ail commands to the 41 1 4 terminal are ultimately sent 
as a sequence of individual ASCII characters. However, 
to describe each operation in terms of those individual 
characters would be both tedious and confusing. 
Therefore, a number of notational conventions are used 
throughout this manual. 

SYNTAX RULES 

In this manual, command syntax is represented ac- 
cording to the following rules. 

Rule One. Individual ASCII characters sent to or from 
the terminal are enclosed in parentheses, (in the jargon 
of compilers and parsers, these are the "terminal 
symbols" of the 411 4 command language.) 



Examples: 

(A) 

(a) 

(ESC) 

(DEL) 

(US) 
(SO) 



The ASCII uppercase "A" character. 

The lowercase "a" character. 

"Escape" control character. 

"Delete" character (also called "rub 
nut"! 

"Unit separator" control character. 
"Shift out" control character. 



The parentheses characters are an exception; to 
decrease confusion, they are represented as follows: 

("(") "Left parenthesis" character. 

(")") "Right parenthesis" character. 



Rule Two. Expressions enclosed in "angle brackets" 
represent sequences of ASCII characters which might 
be sent to or from the 41 1 4. (in the jargon of compilers 
and parsers, these are the "non-terminal symbols" of 
the "41 14 command language.") 

NOTE 

You can find the exact syntax of any such "angle 
bracket" expression by referring to the 4110 
Series Command Reference Manual. 

For example, the following expressions, since they are 
enclosed in "angle brackets," represent syntactic 
constructs defined in the 41 10 Series Command 
Reference Manual: 

< set-baud- A command that sets the transmit and 
rates> receive baud rates (data rates) for 

communicating with the host compu- 
ter. 

< int> An integer number as encoded for 

transmission to the terminal. 

< xy> A pair of x- and y-coordinates as 

encoded for transmission to the termi- 
nal as a part of a command. 

Rule Three. To represent specific examples of com- 
mands or other syntactic constructs, specific values 
are included between the angle brackets. For example: 

< set-baud- A command to set receiving and trans- 
rates: 1 200, mitting data rates to 1 200 baud (1 200 
1200> bits/second). 

< int: — 35> The number —35, as encoded for 

transmission to the terminal. 

< xy: The coordinate pair x= 0, y= 1 00, as 
(0,1 00)> encoded for transmission to the termi- 
nal. 
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Rule Four. In defining the syntax of a command, the 
equals sign (= ) means "has the following syntax." For 
example: 

< set-baud-rates>= (ESC)(N)(R)< int+ > < int+ > 

Rule Five. In syntax definitions, the word "or" means 
"or alternatively." For example: 

< set-alphatext-font> = (ESO(SI) 

or (ESC) (SO) 

Rule Six. In syntax definitions, square brackets delimit 
items which may be omitted. For example: 

< int> = [< Hil>][< Hil>]< Lol> 

This could be expressed in words as, "An < int> 
consists of zero, one, or two < Hil> s, followed by a 
<Lol>." 

Rule Seven. Syntactic constructs which may be re- 
peated any number of times are followed by three dots. 
For example: 

<fill-pattern-definition>= <begin-fill-pattern> 

[< pixel-def> . . .] 
< end-fill-pattern > 

This could be expressed in words as, "A <fill-pattem- 
definition> consists of a <begin-fill-pattern> com- 
mand, followed by zero or more < pixel-def> s, followed 
by an <end-fill-pattern> command." 

EXAMPLES 

Since the < begin-segment> command is represented 
with "angle brackets," it has a syntax definition in the 
41 10 Series Command Reference Manual. In that 
manual, the < begin-segment> syntax is given as 
follows: 

< begin-segment> = (ESC)(S)(0)< int> 

This means that the < begin-segment> command is 
sent to the terminal as three ASCII characters — 
"escape," "uppercase S," and "uppercase O," followed 
by an < int> parameter. 

Since the < int> parameter is represented with angle 
brackets, it too has a syntax definition in the Command 
Reference Manual. 



A particular example of the < begin-segment> 
command is the < begin-segment: 1 > command. That 
can be represented as follows: 

< begin-segment: 1>= (ESC)(S)(0)<int: 1> 

Referring to the Command Reference Manual's discus- 
sion of the < int> parameter type, notice that < int: 1 > 
is the single ASCII character for the digit 1 : 

<int: 1>=(1) 

Thus, you can expand the < begin-segment: 1 > com- 
mand as follows: 

< begin-segment: 1>= (ESC)(S)(0)<int: 1> 

= icoomSmum i s 

Again, consider the < set-baud-rates: 600, 600> com- 
mand. The 41 1 Series Command Reference Manual 
gives the syntax for < set-baud-rates> as follows: 

< set-baud-rates> = (ESC)(N)(R)< int+ > < int+ > 

Referring to the discussion of the Command Reference 
Manual on < int+ > , you can expand the < set-baud- 
rates: 600, 600> command as follows: 

< set-baud-rates: 600, 600> 

= (ESC)(N)(R) < int+ : 600> < int+ : 600> 
= (ESC)(N)(R)(e)(8)(e)(8) 

Thus, a < set-baud-rates: 600, 600> command is sent 
to the terminal as the following sequence of ASCII 
characters: 

(ESC) (N)(R) (e)(8) (e)(8) 

The same notation may be used to express the 
meaning of parameters, especially in the more compli- 
cated syntax definitions. For instance, the meaning of 
the < set-baud-rate> command's two parameters can 
be expressed as follows: 

< set-baud-rates>= (ESC)(N)(R) 

<int+: transmit-rate> 
<int+: receive-rate> 

Here, the italicized expressions transmit-rate and re- 
ceive-rate tell the meanings of the < int-t- > 

parameters. 
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All commands to the 41 1 4 are sent from the host 
computer as a sequence of ASCI! characters. A few of 
these commands consist of a single character; some 
are comprised of two characters; however, most 
consist of three or more characters. 

ONE-CHARACTER COMMANDS 

The following commands consist of only one ASCII 
character. Like all commands, they are described fully 
in the Command Reference Manual. 

<enter-alpha-mode>= (US) 

< enter-vector-mode> = (GS) 
<enter-marker-mode> = (FS) 

TWO-CHARACTER COMMANDS 

Most commands consist of escape sequences — 
sequences of ASCII characters beginning with the 
(ESC) character. A few of these commands consist of 
only two characters: 

<enable-4010-GIN>= (ESO(SUB) 

< enter-bypass-mode> = (ESO(CAN) 
<page>=(ESC)(FF) 
<report-4010-status>= (ESO(ENQ) 
<set-alphatext-font>= (ESC)< (SI) or (SO)> 
<set-4014-line-style>= (ESC)<char> 
<4010-hard-copy>= (ESO(ETB) 

COMMANDS OF THREE OR MORE 
CHARACTERS 

Most of the 41 1 4 commands are escape sequences of 
three or more characters. These commands take the 
following format: 

1 . The first character is (ESC). This serves as a "flag" 
to tell the 41 1 4 that the following characters 
comprise a command for it. 

2. The next two characters comprise an op code to 
identify the command. 



After the op code there may be one or more 
parameters of the following types: 



<int> or 
< int+ > 

<int- 
array> 



< real> 



<xy> 



<char> 



< char- 
array> or 
<string> 



A sequence of characters repre- 
senting an integer number. 

An array of < int> parameters, in- 
cluding a "count" for the array sent 
as an < int> parameter at the be- 
ginning, (See the discussion of 
<array> parameter types in the 
41 10 Series Command Reference 
Manual.) 

A sequence of two < int> parame- 
ters which together represent a 
single real number: 

< real> = < int> < int> 

(Exactly how these two < int> s 
represent a real number is de- 
scribed In the 41 1 Series Com- 
mand Reference Manual in the 
discussion of the <real> parame- 
ter type.) 

A sequence of characters repre- 
senting x- and y-coordinates for 
some location on the 41 1 4's 
screen. 

A single ASCII character in the 
range from (SP) to (~): ASCII deci- 
mal equivalents from 32 to 1 26. 

An array of <char> parameters, 
preceded by a count, expressed as 
an < int> parameter. 



When the terminal is receiving the parameter for a 
command, it ignores any characters (a) which are 
not valid characters for the parameter being re- 
ceived, and (b) which are not the "command 
terminator" characters: (ESC), (US), (GS), and (FS). 
For instance, most ASCII control characters are 
ignored; thus (CR) characters or other interline 
characters can be inserted within the command's 
parameters with no ill effect. (This is useful if the 
parameter is a very long < string> or < int-array> .) 
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Finally, the command is "terminated" — it comes to 
an end. A command can be terminated in two ways: 

• The command ends when all its parameters have 
been sent to the terminal. 

• A command may be terminated early (before all 
its parameters have been sent) by sending any of 
the following characters: 

(ESC). A command ends with the (ESC) character 
that begins another command. 

(US), (GS), and (FS). A command ends whenever 
the terminal receives a (US), (GS), or (FS) charac- 
ter. These characters have their usual effects as 
<enter-aipha-mode> , < enter-vector-mode> , 
and <enter-marker-mode> commands. 



Defaults for Missing Parameters 

When a command is terminated early, the 41 1 4 
assigns default values to the missing parameters. 



These defaults are usually: 

• for < int> parameters 

• O.0for<real> parameters 

• (0,0) for <xy> parameters 

• (NUL) for <char> parameters 

• for < code> parameters 

• an array of elements for < array> parameters 

Assigning (NUL) as the default for missing <char> 
parameters is an exception to the rule that <char> 
parameters must represent characters in the range 
from (SP)to(-). 

NOTE 

Some commands are exceptions. When those 
commands are terminated early, the 411 4 as- 
signs other defaults than those just listed. The 
only reliable way to determine the defaults used 
by a particular command is to consult the de- 
scription of that command in the 4110 Series 
Command Reference Manual. 
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Parameters for escape-sequence commands may be 
variables of several different data types. Each such 
data type has its own syntax and coding scheme. The 
parameter types are: 

< int> and Integer numbers are sent to the termi- 

< int+ > nal as < int> or < int+ > parameters. 

These two parameter types have the 
same syntax and the same coding 
scheme; they differ only in the range 
of valid values. < lnt> parameters 
represent integers in the range from 
—32768 to + 32767. < Int-f- > param- 
eters represent integers from to 
+ 65535. 

An array of integers consists of an 

< int> (or < int+ > ) telling how many 
items are in the array, followed by 

< int> s for each of the items in the 
array. 



<int- 
array> and 
<int+ 
— array> 



< real> < Real> parameters represent num- 

bers which can assume fractional val- 
ues. Each <real> parameter consists 
of two < int> parameters. The first 

< int> represents a number, while the 
second < int> represents a power of 
two by which that number is to be 
multiplied. 

< Real> parameters can assume val- 
ues from —32767.0 to + 32767.0. 

<char> <Char> parameters are individual 

ASCII characters in the range from 
(SP) to (~). (They have decimal equiv- 
alents in the range from 32 to 1 26.) 
They represent the displayable ASCII 
characters. 



<string> or 

<char- 

array> 



<xy> 



<String>s, or <char-array>s, con- 
sist of an <int> (or <int+>) telling 
how many characters are in the string, 
followed by <char>s for each of 
those characters. 

An (x,y) coordinate pair as encoded for 
transmission to the terminal. The 
<xy> parameter syntax is described 
in Section 5, and in the 41 10 Series 
Command Reference Manual. 



<INT> AND <INT+> PARAMETERS 

tnw ^i.iw^- gnu -^inii y |urai aiiicioi i/pco nave mc 

same packing scheme and the same syntax. These 
parameter types differ only in the range of valid values: 
-32768 to + 32767 for <int> parameters, and to 
65535 for < int-f- > parameters. The < int> and 
<int+ > syntax is as follows: 

<int>=[<Hil>] [<HM>] <Lol> 

<int+>=[<Hil>] [<Hil>] <Lol> 

where 

< Hil>= an ASCII character in the range from (@) to 

(DEL) — except that the character sequence 
(ESC)(?) may be used instead of (DEL). 

< Lol>= an ASCII character in the range from (SP) to 

(?). 



Example 

Figure 2-1 shows the packing scheme, using the 
number + 31 41 6 as an example. 
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1 . The number to be sent is represented as a 1 6-bit signed binary numeral: 

+ 31416 10 = +0111101010111000 2 

2. That binary numeral is arranged in groups of 6, 6, and 4 bits: 

+ ,011110, ,101011, ,1000, 

3. If the most-significant six bits are all zero, then the first < Hil> character may be omitted. In this case, they 
are not all zero, so they are used (together with a "tag" bit of 1 ) to form the first < Hil> character: 



+ |0 1 1 1 1 0| 10 10 11 10 

' * 

first <Hil> = | 1 |0 1 1 1 1 0|= C"") 

If the most-significant twelve bits are all zero, then BOTH < Hil> characters may be omitted. That is not the 
case in this example. The second <Hil> character is formed from the next least-significant six bits: 



+ 11110 



10 10 11 



second <Hil> = 



10 10 11 



10 
= (k) 



The < Lol> character's least-significant bits are the four least-significant bits of the binary numeral. The 
fifth least-significant bit is 1 if the number is positive, and zero if it is negative. The two high-order bits ("tag 
bits") are "01 " so as to make the < Lol> character fall in the range from (SP) to (?): 

fT] 011110 101011 | 1 | 

J i ' 



1 


1 


10 



<Lol> 
The characters to be sent to the terminal, then, are MM (8): 

<int : 31416> = r)(k)(8) 



= (8) 



Figure 2-1 . Example of < lnt> and < lnt+> Packing Scheme. 
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Table 2-1 lists several examples of < int> parameters. 
(For a more complete list, see Appendix B in the 41 10 
Series Command Reference Manual.) 

Table 2-1 
EXAMPLES OF <INT> PARAMETERS 



Number 


<lnt> Parameter 





(0) 


1 


(1) 


2 


(2) 


3 


(3) 


4 


(4) 


5 


(5) 


6 


(6) 


■ 7 


(7) 


8 


(8) 


9 


(9) 


10 


(:) 


11 


(;) 


15 


(?) 


16 


(A)(0) 


17 


(A)(1) 


-1 


(!) 


-2 


(") 


-15 


(/) 


-16 


(A)(SP) 


-17 


(A)(!) 


1023 


(DEL)(?) or (ESC) (?)(?) 


1024 


(A)(@)(0) 


1025 


(A)(@)(1) 


-1024 


(A)(@)(SP) 


-1025 


(A)(@)(l) 



<INT-ARRAY> PARAMETERS 

Some commands take <int-array> (or 

< int+ — array>) parameters. These consist of se- 
quences of < int> (< int+ >) parameters. The first 

< int> or < int+ > tells how many items are in the 
array. Subsequent <int>s represent the individual 
array items. 

For instance the array of integers (1 , 5, — 1 , 1 6) would 
be sent to the terminal as follows: 

<int-array: (1,5,-1,16) 
= < int: 4> {the count of 4} 

<int: 1> < int: 5> < int: — 1> <int: 16> 

= (4) (1) (5) (I) (A)(0) 

For more information on < int> and < int+ > parame- 
ters, see the descri n tion in the 4110 Series Command 
Reference Manual. 



<REAL> PARAMETERS 

A "real" number is a variable which may assume non- 
integer (that is, fractional) values. Real numbers be- 
tween -32767.0 and + 32767.0 are sent to the 
terminal as < real> parameters. These consist of a pair 
of < int> s. The first < int> represents a number; the 
second < int> represents the power of two by which 
that number is to be multiplied. 

For instance, the number 3.25 may be represented as 
1 3 multipled by two raised to the power —2. Thus, 

<real: 3.25> = <int: 13> < int: -2> 

= (=)(") 

For more information about <real> parameters, see 
the description in the 41 1 Series Command 
Reference Manual. Included there is an example of a 
routine which sends < real> parameters to the termi- 
nal. 
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<CHAR> PARAMETERS 

The < char> parameter type represents displayable 
ASCII characters. Each <char> parameter is a single 
ASCII character in the range from (SP) to (— ). (The 
decimal equivalent of a < char> character is in the 
range from 32 to 1 26.) 

<STRING> OR <CHAR-ARRAY> 
PARAMETERS 

Strings, or arrays of displayable ASCII characters, are 
sent to the terminal as < char-array> parameters. 
Each such parameter consists of an < int> (or 
< int-f- >) telling how many items are in the array, 
followed by one < char> for each array item. For more 
information, see the description in the 41 1 Series 
Command Reference Manual. 

<XY> PARAMETERS 

The <xy> parameter type represents spatial coordi- 
nates. <Xy> parameters are sent as a group of one to 
five ASCII characters. (The packing scheme used is the 
same as that used for earlier TEKTRONIX terminals.) 
The x- and y-coordinates in an <xy> parameter can 
range from to 4095. For more details, see Section 5 
and the 41 10 Series Command Reference Manual. 

REPORT PARAMETER TYPES 

The parameter types described so far are for sending 
command parameters to the terminal. When the termi- 
nal sends messages back to the host computer, it 
packs the information in a different format. Thus, for 
each host-to-terminal parameter type there is a corre- 
sponding terminal-to-host parameter type. Table 2-2 
lists the types: 



Table 2-2 

HOST-TO-TERMINAL AND 
TERMINAL-TO-HOST PARAMETER TYPES 



Data to 
Be Sent 


Host-To-Terminal 
Parameter Type 


Terminal-To-Host 
Parameter Type 


Integer 
(-32768 to 
+ 32767) 


<int> 


< int-report> 


Integer (0 to 
65535) 


<int+> 


< int-report> 


Array of 

Integers 




<int-array> or 
<int+ — array> 


< int-array-report> 



Real 

(-32767.0 

to 

+ 32767.0) 


<real> 


< real-report> 


Displayable 
Character 


<char> 


< char-report> 


String of 
Characters 


<string> or<char- 
array> 


<string-report> 


Spatial 
Coordinates 


<xy> 


< xy-report> 



For more information on < int-report> s, < int-array- 
report> s, < real-report> s, < char-report> s, < string- 
report s, and < xy-report>s, see the descriptions in 
the 41 1 Series Command Reference Manual. 
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THE PROGRAMMING TASK 



This section provides an overview of the graphics 
programming task. Included are examples of how to 
use this manual to write device driver routines for the 
4114. 



Experienced programmers may find this section to be 
too elementary for them. These programmers should 
feel free, if they wish, to skip this section and proceed 
to Section 4. 



GRAPHICS PROGRAM ARCHITECTURE 



Figure 3-1 shows the architecture of a typical compu- 
ter graphics program. The user's program consists of a 
main applications program and a graphic subroutine 
package. All graphic functions are performed through 
calls to subprograms in the graphics subroutine pack- 
age. In turn, that subroutine package communicates 
(through host computer system software and the data 
pommunications line) with the 41 14 terminal. 

The graphic subroutine package includes high-level 
graphics routines, device driver routines, and commu- 
nications interface routines. 

It helps to define standard, uniform interfaces between 
these modules. For instance, a standard interface to 
the communications interface module lets you 
substitute different communications interface modules 
for use with different host operating systems. Likewise, 
you may wish to substitute different device drivers for 



etc.). 
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THE APPLICATIONS PROGRAM 

The applications program is the main program; you 
write this program to perform the particular task you 
have in mind. The design of applications programs is 
beyond the scope of this manual. 
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Figure 3-1 . Graphics Program Architecture. 
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GRAPHICS SUBROUTINE PACKAGE 

There should be a standard, uniform interface between 
the applications program and the graphics subroutine 
package. (That way, you can use the same subroutine 
package with different applications programs.) 

It is not good practice for the applications program to 
interface directly to the terminal, issuing commands to 
the terminal itself. Such a program is difficult to change 
for use with another graphics output device, such as a 
plotter or another terminal. Your applications program 
should interface to the terminal only by calls to 
standard routines in the graphics subroutine package. 
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4010C01 PLOT 1 Interactive Graphics Library) is one 
such subroutine package. 

Whatever graphics subroutine package you use 
(whether it be IGL or one which you write yourself), that 
package will typically be subdivided into high-level 
graphics routines, device driver routines, and commu- 
nications interface routines. 



References 

For information on the TEKTRONIX 4010C01 PLOT 10 
Interactive Graphics Library, see the following TEK- 
TRONIX manuals: 

• 4010C01 PLOT 10 Interactive Graphics Library 
User's Manual 

• 4010C01 PLOT 10 IGL Option 4A Graphic Seg- 
ments Support User's Manual 

HIGH-LEVEL GRAPHICS ROUTINES 

The high-level graphics routines provide the interface 
to the applications program. These routines perform 
functions such as selecting a graphic output device, 
moving graphic objects from place to place in the 
user's coordinate space, and manipulating graphic 
objects. 



The graphics package may provide for performing 
these high-level functions on a variety of graphic 
output devices (different terminals, different plotters, 
etc.). In order to do this, the high-level graphic routines 
use calls to standard routines in device driver 
subroutine packages. 

As far as it is possible, there should be identical 
interfaces between the high-level graphics routines 
and the device driver routines for different terminals or 
plotters. 

References 

nnqpribinn how to writs hioh-lovol nraohics rnntinns 

and applications programs is beyond the scope of this 
manual. For more information on these subjects, you 
may wish to consult the following references: 

• William M. Newman and Robert F. Sproull, Principles of 
Interactive Computer Graphics. Second Edition. 
McGraw-Hill Book Co., New York, 1 979. 

• Association for Computing Machinery, Special Interest 
Group on Graphics, Graphics Standards Planning 
Committee, "Status Report of the Graphics Standards 
Planning Committee." Computer Graphics, Volume 13, 
Number 3, August 1979. (Available from ACM, P.O. Box 
1 2105, Church Street Station, New York, New York 

1 0279.) 
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DEVICE DRIVER ROUTINES 

The device driver subroutines are the ones which 
actually issue commands to the terminal. The more 
primitive of these routines each issues just one 
command. For instance, there may be a routine which 
causes the terminal to draw a line between two points 
on its screen; that routine probably calls more primitive 
routines to issue < enter-vector-mode> commands 
and <xy> parameters. 

When writing device driver routines, you will definitely 
be referring to this manuai and to the 4110 Series 
Command Reference Manual; writing device driver 
routines is discussed more fully later in this section, 
under "Issuing Commands to the Terminal" and "Pars- 
ing Messages From the Terminal." 

COMMUNICATIONS INTERFACE 

nV/uTln&5 

The device driver routines must have a way to send 
and receive individual ASCII characters. The tech- 
niques for doing this may be different on different host 
computers. To enhance portability from one host 
computer to another, therefore, it is wise to send and 
receive characters only through calls to standard 
communications interface routines. 

This latter point is especially important if you will be 
using the 41 1 4's block mode communications feature. 
While the terminal Is in block mode (which requires 
Option 01), all characters sent to and from the terminal 
must pass through the communications interface rou- 
tines which handle the details of the block mode 
protocol. 

Another task of the communications interface routines 
is to ensure that no data is lost in the transmissions 
between the host computer and the 41 1 4 terminal. In 
this regard, problems may occur (a) when sending 
commands to change the terminal's communications 
settings, and (b) when sending a large number of 
commands to the terminal. 



Changing the Terminal's Settings 

When sending commands to change the terminal's 
communications or display settings, you should pause 
after sending the commands before sending more data 
to the terminal. The pause lets the terminal finish 
executing the commands. If you do not pause, the first 
few characters of data may be processed incorrectly 
before the terminal's settings are changed. 

How do you make the host program wait until the 
terminal is ready? Either by "handshaking," by putting 
your program in a "wait" siate, or by sending a number 
of "no-op" characters. Handshaking is useful primarily 
for arming and disarming block mode, while waiting is 
preferable for entering prompt mode. Some computers 
allow programs to enter a "wait" state for a programm- 
able amount of time. For other systems, transmitting 
no-op characters — such as (SYN) or (NUL) — for 
about half a second should suffice. 

Handshaking 

"Handshaking' means exchanging control signals 
between the host program and the terminal. Its purpose 
is to ensure that the terminal does not receive data 
while it is busy changing its communications settings, 
and that the terminal does not receive commands 
faster than it can execute those commands. 

To handshake after sending commands to change the 
terminal's settings, send a < report-401 0-status> 
command. (Other "report" commands can be used; but 
< report-401 0-status> consists of only two charac- 
ters: (ESCHENQ).) 

When the terminal is finished changing its settings, it 
then executes the < report-401 0-status> command 
and sends a < 401 0-status-report> to the host com- 
puter. The host receives the < 401 0-status-report> ; 
only after reading this report message does it proceed 
to send more data to the terminal. 
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Figure 3-2 shows a FORTRAN routine which may be 
used to perform this "handshake" operation. 

Preventing the Input Queue From 
Overflowing 

if the average rate at which the host sends commands 
exceeds the average rate at which the terminal can 
execute those commands, then, sooner or later, the 
terminal's communications input queue will overflow. 



The 4114 can display simple alphatext and graphics, 
continuously, at data rates up to 19200 bits per 
second. However, there are many commands (such as 
< include-copy-of-segment> or <load>) which take 
an indeterminate amount of time to execute. Thus, if 
commands come thick and fast, it is possible to 
overrun the terminal's communications input queue. 
Should this occur, data would be lost; the terminal 
would not execute all the commands it receives. 



SUBROUTINE HNDSHK 

C Send <report-H0 1 0-status> commend, (ESO(ENQ). 

C This routine uses the subroutine SENDCH. The SENDCH 

C routine, given a number in the range from to 127, 

C sends the corresponding ASCII character to the terminal. 

C Thus CALL SENDCHC27) sends the (ESC) character, and 

C CALL SENDCH(5) sends the (ENC) character. 

CALL SENDCH(27) 
CALL SENDCH(5) 

C Read (and ignore) the <iJ010-status-report> . (This report 
C consists of five characters, followed by a carriage return 
C or other end-of-line indicator.) 



100 



READ (ITTY, 100) 
FCRMATU5) 



REPORT 



If the host computer provides an echo of characters which the 
the terminal sends, then the last character of the "echo" 
can serve as the terminal's <bypass-cancel-character> . In that 
case, the following statement can be omitted. This statment 
sends a (LF) as the <bypsss-cancel-character> . 



CALL SENDCHdO) 



C Once the report has been read, it is safe to proceed to 
C tasks, and perhaps send more characters to the terminal 

RETURN 



other 
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Figure 3-2. A Handshaking Routine. 
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The terminal's prompt mode and flagging modes, and 
Its optional block mode, provide a variety of handshak- 
ing techniques. Any of these techniques will prevent 
the terminal's input queue from overflowing. The user 
applications program need not concern itself with 
these handshaking techniques; they can be handled by 
routines in the device driver or communications inter- 
face modules. (See Section 1 for information on 
prompt mode and flagging, and Section 1 1 for informa- 
tion on block mode.) 



Of course, the communications routines can also do 
handshaking, using (for instance) the < report-4010- 
status> command: (ESO(ENQ). That is, the 
communications routines can set the terminal input 
queue size to N characters (< set-queue-size> com- 
mand). Then, after sending N characters, those rou- 
tines can send a <report-4010-status> command and 
input the < 401 0-status-report> that the terminal 
returns. This handshaking guarantees that the termi- 
nal's input queue is empty, ready to receive more 
characters. 



ISSUING COMMANDS TO THE TERMINAL 



ROUTINES WHICH ISSUE SEVERAL 
COMMANDS 

The examples given in the later sections of this manual 
will give you clues on how to write higher-level device 



driver routines. For instance, Figure 3-3 shows one 
such example. 

Thus, to initialize the terminal's dialog area in exactly 
the way shown in the Figure 3-3, you may write a 
device driver routine like that in Figure 3-4. 



To prepare a dialog area, you might issue the following commands: 



<set— alphatext— size: 6,4,1 4> 
<set— dialog— area— lines: 40> 
<set— dialog— area— chars: 50> 
< set— diaiog— area— position: (O,0)> 

< enable— dialog— area: 1 > 

<set— dialog— area— visibility: 1> 



Selects a fairly small size for the alphatext to be displayed. 

Up to 40 lines of the dialog area can be viewed at any one time. 

Each line can hold up to 50 characters. 

The "diaiog viewport" is to be in the iower ieft corner of the 
screen. 

Alphatext from the host will be be displayed in the dialog area 
rather than the graphic area. 

Make the dialog area visible. 
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Figure 3-3. An Example with Several Commands. 
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In 3-4, several procedures are invoked to change the 
terminal's dialog area settings. (Each of these pro- 
cedures sends a single command to the terminal.) The 
Handshake procedure guarantees that the terminal's 
settings have been changed before the host sends 
more characters to the terminal. (This procedure is just 
a PASCAL version of the HNDSHK FORTRAN subrou- 
tine shown earlier in this section.) 



ROUTINES TO ISSUE A SINGLE 
COMMAND 

Of course, the procedure in Figure 3-4 only works if 
you also write device driver routines to issue each of 
the commands it invokes. To write these routines, you 
should consult the 41 1 Series Command Reference 
Manual. For instance, that manual gives the < set- 
dialog-area-lines> syntax as follows: 

<set-dialog-area-lines>=(ESCMU(L)<int> 

From this syntax definition, you can write a routine like 
that in Figure 3-5. 



PROCEDURE Initialize Dialog Area; 
BEGIN 

SetAlphatextSize(6,4,l4); 
SetDialogAreaLines(40) ; 
SetDialogAreaChars(50) ; 
SetDialogAreaPosition(0,0) ; 
SetDialogAreaWritingMode(O) ; 
EnableDialogArea ( 1 ) ; 
SetDialogAread ) ; 
SetDialogAreaVisibility( 1 ) ; 
Handshake ; 
END; {** of InitializeDialogArea procedure **} 
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Figure 3-4. A Device Driver Routine to Issue Several Commands. 



PROCEDURE SetDialogAreaLinesCNumberOfLines : INTEGER); 



character **} 



BEGIN 

SendAscii(27); {** Send the (ESC) 
SendAscii(76); {** letter L **} 
SendAscii(76); {*» letter L **} 
Sendlnt(NumberOfLines) ; 

END; {** of SetDialogAreaLines procedure **} 



Figure 3-5. A Device Driver Routine Which Issues One Command. 
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ROUTINES TO ISSUE COMMAND 

The example in Figure 3-5 in turn calls two lower-level 
procedures. SendAscii issues a single character to the 
terminal (possibly using block mode, if the terminal is 
in block mode). Sendlnt sends a single < int> 
parameter to the terminal. 

When writing routines to issue command parameters, 
you should again consult the 41 10 Series Command 
Reference Manual. For instance, when writing a routine 
to send an < int> parameter to the terminal, you should 
consult that manual about the < int> parameter type. 



SUMMARY 

When writing higher-level device driver routines, which 
issue several commands to the terminal, see the 
examples given in other sections of this manual. When 
writing lower-level device driver routines, which issue 
single commands (or single parameters) to the termi- 
nal, see the 41 1 Series Command Reference Manual. 



PARSING REPORT MESSAGES FROM THE TERMINAL 



Certain commands, such as <enable-GIN> or <re- 
port-terminal-settings> , cause the terminal to send a 
"report" message back to the host computer. When 
writing device driver routines to parse (read and accept 
data from) these reports, you must consult the 41 1 
Series Command Reference Manual. There you will find 
the exact syntax of each report message; use those 
syntax specifications when writing routines to parse 
the different report messages. 



Suppose, for instance, that you are writing a routine to 
parse a < 401 0-status-report> . (This is the message 
which the terminal sends in response to the < report- 
401 0-status> command.) According to the 41 1 
Series Command Reference Manual, this report has the 
following syntax: 

< 401 0-status-report> = < 401 0-GIN-status-report> 

or <4010-non-GIN- 
status-report> 

< 401 0-GIN-status-report> = < 401 0-xy-report> 

<eom-indicator> 

< 401 0-non-GiN-status-report> = < 401 0-status- 

byte> 

< 401 0-xy-report> 

<eom-lndlcator> 
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(The <4010-GIN-status-report> is used if the terminal 
has been enabled for GIN (graphic input) with an 
< enable-401 0-GIN> command. Otherwise, the 
<4010-non-GIN-status-report> is used.) 

A routine to parse < 401 0-status-report> may look like 
the one shown in Figure 3-6. In this example, a global 
flag variable (In401 OGinMode) and other parsing rou- 
tines are needed. Those routines would be written in a 
similar manner. 

PARSING <EOM-INDICATOR>S 

The syntax of many report messages includes <eom- 
indicator>s. Sometimes these are "optional" — the 
terminal may or may not send them, depending on 
conditions listed in footnotes to the syntax of the 
particular report. 



If the terminal is in block mode (which requires 
Option 01), then it sends each <eom-indicator> by 
terminating the block and setting the end-of-message 
bit in that block's <block-control-bytes> . (See the 
description of block mode in Section 1 1 for details.) 
The host program's communications interface routines 
should handle the block mode protocol. The parsing 
routines in the host program's device driver module 
should never see the < eom-indicator> s. 

If the terminal is not in block mode, then when it sends 
an < eom-indicator> , it sends the < eom-indicator> as 
the current <eol-string> . The <eol-string> is a 
sequence of one or two characters, set by the most 
recent <set-EOL-string> command.The < eol-string> 
is typically (CR) or (CRJ(LF). 



PROCEDURE ParseA4010StatusReport(VAR StatusEyte : INTEGER; 

VAR Xy : Xylype); 
BEGIN 
IF InMOIOGinMode {** a global flag ** } 

THEN {** parse a <401 C-GIN-status-report> ** } 
EFGIN 
{** Clear the StatusEyte variable **} 

StatusEyte := 0; 
ParseJU010XyReport(Xy) ; 
Parse An Eom Indicator ; 
InHOIOGinMode := FALSE; 
END 
ELSE {** if NCT In4010GinHode **} 

EEGIN {** parse a <*1C1 C-non-GIN-status-report> **} 
Par seA4010StatusEyte( StatusEyte) ; 
ParseA4010XyReport(Xy) ; 
Parse An Eom In die a tor 
END 
END; {** of ParseA4010StatusReport procedure **} 
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Figure 3-6. Example of a Parsing Routine. 
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To make it easier to parse reports from the terminal, 
you should choose an <eol-string> which consists 
only of ASCII control characters. These are ASCII 
characters - such as (CR) or (LF) — with numeric 
equivalents in the range from to 31 . The other parts 
of the report (the parts other than the <eom-indica- 
tor>) typically do not include control characters. Thus, 
if the terminal is not in block mode, it can skip over any 
control characters it encounters. 



SIGNATURE CHARACTERS 

Most of the report messages which the terminal sends 
to the host begin with "signature characters." When 
several graphic input devices are enabled at the same 
time, the reports from different devices are marked with 
different signature characters. The signature charac- 
ters indicate which type of report message is being 
sent and thus help you parse the report. 

For more information on signature characters, see 
Sections 8 and 9. 
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DISPLAY AND KEYBOARD SETTINGS 



CONTROLLING THE DISPLAY 



CONTROLLING EFFECTS 
OF (CR) AND (LF) 

Normally, one must send the 4i i 4 both (CR) and (LF) 
to cause its cursor to move to the start of a new line: 
(CR) to move the cursor left to the current margin, and 
(LF) to move it down one line. However, some hosts 
may send only (CR), or only (LF); to cope with these 
hosts, the 41 1 4 has the < set-crlf> and < set-lfcr> 
commands. Tabie 4-1 shows examples of these; for 
more information (such as the command syntax), see 
the descriptions of these commands in the 41 1 Series 
Command Reference Manual. 



Table 4-1 

CONTROLLING THE EFFECTS OF (CR) AND (LF) 
CHARACTERS 



Example 


Description 


< set-crlf : 1 > 

= (ESC)(K)(R)<int:1> 

= (ESC)(K)(R)(1) 


This command causes the 
41 1 4 to respond to a single 
(CR) character as If It were 
(CRKLF). 


< set-ifcr: 1 > 

= (ESCKK)(F)<lnt:1> 

= (ESC) (K) (F)(1) 


This command causes the 
41 1 4 to respond to a single 
(LF)aslfltwere(LFMCR). 


< set-crlf: 0> 

- (ESC)(K)(R)<int:0> 
= (ESC)(K)(R)(0) 

< set-lfcr: 0> 

= (ESC)(K)(F)<lnt:0> 

- (E8C)(K)(F)(0) 


Issuing both these commands 
disables the effect of any 
preceding < set-crlf: 1 > and 
< set-lfcr: 1 > commands. 



CONTROLLING THE KEYBOARD AND DEFINING MACROS 



LOCKING THE KEYBOARD 

The host computer can prevent the terminal's operator 
from typing inappropriate commands by locking the 
keyboard during critical operations. To do this, the host 
issues the < lock-keyboard > command: 

< lock-keyboard >= (ESC)(K)(L)<int> 

Here, the < lnt> is one to lock the keyboard, and zero 
to unlock it. When the keyboard Is locked, the KBD 
LOCK light turns on and typing on the keyboard only 
rings the be!!. Table 4-2 shows how to Issue the 
command. 



Tabto 4-2 
LOCKING AND UNLOCKING THE KEYBOARD 



Example 


Description 


< lock-keyboard: 1> 

- (ESC)(K)(L)<lnt: 1> 

- (E8C)(K)(L)(1) 


Locks the keyboard. 


< lock-keyboard: 0> 

- (ESC)(K){L)<lnt:0> 

- (E3C)(K)(L)(0) 


Unlocks the keyboard. 
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DEFINING MACROS (AND PROGRAMMING 
KEYS) 

The <define-macro> command defines a "macro" - a se- 
quence of characters that is referred to by a macro number. 
"Invoking" a macro means to use a macro in place of one of 
its representations. A macro is invoked in one or more of the 
following ways: 

• The terminal receives an <expand-macro> command. 

• The terminal receives a byte corresponding to the macro. 

• The operator presses a key corresponding to the macro. 

Macros are referenced by macro numbers in the following 
ranges: 



007AD +\~ s r^,,„i~* 00-7/0 


k>yte macros 


-32740 through -32737 


byte macros 


-32608 through -32513 


byte macros 


-1 


deletes all macros 


through 143 


key macros 


144 through 32767 


host macros 



Key and host macros can be invoked with the < expand- 
macro> command. An <expand-macro> command speci- 
fies a particular macro number and invokes the correspond- 
ing macro. In effect, the terminal replaces the < expand- 
macro> command with the characters in the macro's defi- 
nition and responds as if it received those characters in its 
input stream. 

Key macros can also be invoked by pressing the key (or key 
combination) that produces the ASCII decimal equivalent 
equal to the macro number. For example, the ASCII decimal 
equivalent of the uppercase P is 80. If macro number 80 has 
been defined, pressing uppercase P invokes that macro. 
Function keys also correspond to macro numbers as de- 
scribed later. 

Byte macros are invoked whenever the terminal receives a 
character that matches a defined macro number. A charac- 
ter is matched to a macro number by adding the character's 
decimal equivalent to -32768. For example, the EM charac- 
ter, whose decimal equivalent is 25, invokes macro -32743 
(-32768 + 25). Note that several characters that might cause 
problems if defined as macros match invalid macro num- 
bers. For example, ESC (ASCII decimal equivalent 27) 
matches -32741 , an invalid macro number. 

The < deflne-macro> command has this syntax: 

< deflne-macro> = (ESC)(K)(D)<lntxlnt-array> 

Here, the < int> parameter names the macro to be 
defined. The < int-array> is an array of numeric 
equivalents for the characters being programmed into 
the macro. For Instance, you can program the "upper- 
case A" key to mean "HI!" by Issuing the following 
command; 



<define-macro: 65, "Hil"> 

= (ESCKKMD) 
<int:65> 
<lnt-array:(72,105,33)> 

= (ESO(KMD) 

< int: 65> 

< int: 3> < int: 72> < int: 1 05> < int: 33> 

= (ESCHKHD) 
(D)(1) 
(3) (D)(8) (F)(9) (B)(1) 

= (ESC)(K)(D)(D)(1 )(3)(D)(8)(F)(9)(B)(1 ) 

In the example, the three ASCII characters (H)(i)(!) are 
represented in the <iiii-ariay> parameter by their 
decimal equivalents: 72, 1 05, 33. Since 65 is the ASCII 
decimal equivalent for the letter A, macro number 65 
can be invoked by typing the ASCII character A on the 
keyboard. 

This macro may also be invoked from the host by 
means of the < expand-macro> command: 

<expand-macro: 65> 
= (ESC)(K)(X)<lnt:65> 
= (ESC)(K)(X)(D)(1) 

Macro numbers in the range from 1 28 to 1 43 corre- 
spond to the programmable function keys, as follows: 



128 
129 
130 
131 
132 
133 
134 
135 
136 
137 
138 
139 
140 
141 
142 
143 



Function 
Function 
Function 
Function 
Function 
Function 
Function 
Function 
Function 
Function 
Function 
Function 
Function 
Function 
Function 
Function 



keyF1 
keyF2 
keyF3 
keyF4 
keyF5 
keyF6 
keyF7 
keyF8 
keyS1 
keyS2 
key S3 
keyS4 
keyS5 
keyS6 
keyS7 
keyS8 



(SHIFT-F1) 
(SHIFT-F2) 
(SHIFT-F3) 
(SHIFT-F4) 
(SHIFT-F5) 
(SHIFT-F6) 
(SHIFT-F7) 
(SHIFT-F8) 



Host macros (numbered 144 through 32767) can only be in- 
voked by the <expand-macro> command. Although it 
might seem easier to always use byte macros, since they 
are easier to invoke, you can have only 1 27 byte macros de- 
fined at any one time. Using host macros lets you use many 
more macros. 

For more Information, see the Command Reference 
Manual for descriptions of the <deflne-macro> and 
<expand-macro> commands. 
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< KEY-EXECUTE-CHARACTER> 

Normally, when the operator presses a key which has 
been programmed (with the < define-macro> com- 
mand), the characters programmed into the key are 
sent to the host computer, just as if the operator had 
typed those characters on the keyboard. This includes 
characters which comprise an escape-sequence com- 
mand for the terminal; instead of executing such a 
command, the terminal sends the characters which 
comprise that command to the host computer. 

The < key-execute-character> provides a way around 
this difficulty. You issue a < set-key-execute- 
character> command to designate one of the ASCII 
characters as the < key-exec ute-character> . Then, 
when programming a key (that is, when defining a 
macro numbered from to 1 43), you can place < key- 
execute-character>s at the start and end of part of the 
text being programmed into the key. Later, when the 
operator presses that key, the characters between the 

< key-execute-character>s are not sent to the host 
computer. Instead, the terminal responds to those 
characters iocally, as if it were receiving them from the 
host. 

The < key-execute-character> within a macro has its 
special effect only if the macro is invoked by pressing 
a key. If the macro is invoked with the < expand- 
macro> command, then any < key-execute-charac- 
ter>s within it have no special effect. 



EXAMPLES 

Programming a Key to Type a Message to 
the Host 

Suppose you want to program a function key to log you 
off the host computer, and that your host computer 
accepts the following characters as a command to log 
off: 

(L)(0)(G)(0)(F)(F)(CR) 

From an ASCII chart (Appendix A), you find that those 
characters have the following decimal equivalents: 



(L) 


76 


(0) 


79 


(G) 


71 


(0) 


7Q 


(F) 


70 


(F) 


70 


(CR) 


13 



You can program function key F1 by sending the 
following command to the terminal: 

<define-macro: 128, (76,79,71, 79,70,70,1 3)> 

= (ESCKKMD) 
<int:128> 
< int-array: (76,79,71 ,79,70,70,1 3)> 

= (ESCKKMD) 
(H)(0) 
(7) (D)(<) (D)(?) (D)(7) (D)(?) (D)(6) (D)(6) (=) 



= veokyMr\.nunnHUM7MDn< mum O 
(D)(7)(D)(?)(D)(6)(D)(6)(=) 
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Programming a Key to Display a Message 
Locally 

The following commands program function key F1 to 
display the message "HI THERE!" on the terminal's 
screen. (The message is not sent to the host computer; 
it is only displayed locally in the terminal.) 

< set-key-execute-character: 1 26> 
= (ESC)(K)(Y)<int:126> 
= (ESC)(K)(Y)(G)(>) 

<define-macro: 128, "~HI THERE- "> 

= (ESCKKKD) 
<int: 128> 

< int-array: (1 26,72,73,32,84,72,69,82,69,1 26) > 

= (ESCKKKD) 
(H)(0) 

< int: 1 0> < int: 1 26> < int: 72> ... < int: 1 26> 

= (ESCKKMD) (H)(0) (:) (G)(>) (D)(8) (D)(9) (B)(0) 
(E)(4) (D)(8) (D)(5) (E)(2) (D)(5) (G)(>) 

The first command sets the < key-execute-character> 
to (~), which has an ASCII decimal equivalent of 1 26. 

The second command defines macro number 1 28, 
which can be invoked by pressing function key F1 . The 
numbers in this command's < int-array> are the ASCII 
decimal equivalents of the characters in the "~HI 
THERE—" message. Note that the message begins and 
ends with the (— ) character, which is the current 

< key-execute-character> . When you press function 
key F1 , the "HI THERE" message is executed (dis- 
played) locally, as if it had come from the host 
computer. 

Recall, however, that the < key-execute-character> 
has its special effect only when the macro is invoked 
by pressing the corresponding key (in this case, 
function key F1). If the macro is invoked by an 

< expand-macro: 1 28> command from the host com- 
puter, then the terminal behaves as if it had received 
the entire macro contents (including the (— ) 
characters) from the host computer. 



Programming a Key to Execute a 
Command Locally 

You can program a key (define a macro) using the 
characters that comprise an escape-sequence com- 
mand. 

For example, one easy command is the < page> 
command, (ESO(FF). You can program the < page> 
command into function key F2 as follows: 

< define-macro: 1 29, (1 26,27,1 2,1 26)> 

= (ESCKKKD) 
<int: 129> 

< int-array: (1 26,27,1 2,1 26)> 

= (ESCKKKD) 
<int: 129> 

< int: 4> < int: 1 26> < int: 27> < int: 1 2> < int: 1 26> 

= (ESO(KKD) 
(H)(1) 
(4)(G)(>)(A)(;)«)(G)(>) 

Here, the < int-array> contains the numbers 1 26, 27, 
1 2, 1 26; these are the ASCII decimal equivalents for 
the characters (~)(ESC)(FF)(~). The (~) characters 
are the < key-execute-character>s, while the charac- 
ters between them comprise the < page> command. 
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DISPLAYING ALPHATEXT 



ENTERING AND LEAVING ALPHA MODE 

The 41 1 4 Computer Display Terminal enters alpha 
mode whenever (a) it is turned on, or (b) it receives the 
<enter-alpha-mode> command: the character (US). 

In addition, the <enable-dialog-area> command has 
an effect on other ways of entering alpha mode. (This 
command is described later in this section, in connec- 
tion with the dialog area.) If the 41 1 4 is emulating 
earlier TEKTRONIX terminals (dialog area not enabled), 
then it enters alpha mode whenever: 

a. it receives a (CR) character, 

b. it receives a < page> command, or 

c. the operator presses the PAGE key. 

The terminal leaves alpha mode on receiving an 
< enter-vector-mode> or <enter-marker-mode> com- 
mand. 

The next two tables show how to put the 41 1 4 in alpha 
mode and display a message on its screen. For each 
command, the table shows the individual ASCII 
characters sent to the terminal; also shown are high- 



level language (FORTRAN or PASCAL) statements to 
cause the host to send those characters to the 
terminal. 

NOTE 

The SENDCH subroutine (in Table 4-3) and the 
SendASCII procedure (in Table 4-4) accomplish 
the same purpose. Given the decimal equivalent 
of an ASCII character, these subprograms send 
that character to the terminal. 

The "characters sent" in the two examples are 
those sent by the host computer (aDEC-system 
10) used to test the examples. 

In FORTRAN, the FORMAT statement has a 
"carriage control character" which generates a 
(LF) before the text; the FORMAT statement also 
puts a (CR) after the text. In PASCAL, on the other 
hand, the Writeln statement generates a (CRMLF) 
sequence after the text These differences are 
minor and should cause no concern. 



Table 4-3 
DISPLAYING ALPHATEXT USING FORTRAN 



Command 


Characters Sont 


FORTRAN Statement* 


< enter-alpha-mode> 

< alpha text: "Hi Mom!"> 


(US) 

(LF)(H)(i)(SP)(M)(o) 
(m)(!)(CR) 


CALLSENDCHOD 

WRITE(ITTY.IOO) 
100 FORMATC HI Mornl 1 ) 



Table 4-4 
DISPLAYING ALPHATEXT USING PASCAL 



Command 



< enter-alpha-mode> 

<alphatext: "Hi Mom!'> 



Characters Sent 



(US) 

(HHlHSPHMMoMm) 
(IMCRHLF) 



PASCAL Statements 



SendASCHOD; 

WrltBlnfTTY.'HI Mom!'): 
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CONTROLLING CHARACTER SIZE 

<Set-Alphatext-Size> Command 

You can change the character size for alphatext with 
the < set-alphatext-size> command: 

< set-alphatext-size> 
= (ESCKMHZ) 

<int: scale-tactor> 

< int: inter-character-spacing> 

< int: inter-line-spacing> 

This command may also be given by the operator, using 
the SETUP mode keyword, ALPHASIZE. See the 41 1 4 

Operator's Manual for details. 

Table 4-5 gives examples of several useful <set- 
alphatext-size> settings. 



Table 4-5 
USEFUL ALPHATEXT SIZE 



SETTINGS 



Command 


Effect 


< set-alphatext-size: 1 0, 6, 28> 

= (ESC) (MHZ) 

< int: 1 0> < int: 6> < int: 28> 

= (ESCKMHZ) <:) (6) <A)<<) 


Fits up to 74 
characters per 
line. 


< set-alphatext-size: 9, 6, 28> 

= (ESCKMHZ) 

< int: 9>< int: 6>< int: 28> 

= (ESC)(M)(Z)(9)(6)(A)(<) 


Fits up to 81 
characters per 
line. 


< set-alphatext-size: 6, 4, 1 4> 

= (ESCKMHZ) 

< int: 6> < int: 4> < int: 1 4> 

= (ESCKMHZ) (6) (4) (>) 


Fits up to 1 33 
characters per 
line. 


< set-alphatext-size: 4, 5, 1 2> 

= (ESCKMHZ) 

< int: 4> < Int: 5> < int: 1 2> 

= (ESCKMHZ) (4)(5H<) 


Fits up to 164 
characters per 
line, permitting 
two columnns, 
each holding 
80 characters. 



< Set -401 4-Alphatext-Size> Command 

To be compatible with software written for TEKTRONIX 
401 4 and 401 5 Computer Display Terminals, the 41 1 4 
also has a < set-401 4-alphatext-size> command: 

<set-4014-alphatext-size> = (ESCM8) 

or (ESC) (9) 
or (ESCH:) 
or (ESCH;) 

Table 4-6 gives examples. 



Table 4-6 

USING THE < SET-401 4-ALPHATEXT-SIZE> 
COMMAND 



Command 



< set-401 4-alphatext-size: largest> 
= (ESCH8) 



< set-401 4-alphatext-size: large> 


Equivalent to 


= (ESCK9) 


< set-alphatext-size: 




9,-6,28>; fits up to 81 




characters per line. 


< set-401 4-alphatext-size: small> 


Equivalent to 


= (ESCH:) 


< set-alphatext-size: 




6,- 4,1 7>; fits up to 121 




characters per line. 



< set-401 4-alphatext-size: smallest> 
= (ESCH;) 



Effect 



Equivalent to 
< set-alphatext-size: 
10,6,28>; fits up to 74 
characters per line. 



Equivalent to 
< set-alphatext-size: 
5,-6,1 8> ; fits up to 133 
characters per line. 
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CONTROLLING THE MARGINS 

The < set-margins> command determines the number 
of margins (or number of columns) which the terminal 
uses when displaying text on the screen. In doing so, it 
also defines when it is that a "page full" condition 
occurs. The <set-margins> command has this syntax: 

< set-margins> = (ESC)(K)(M) 

< int: number-of-margins> 

In this command, the < int> parameter may range from 
1 to 8. For more details, see the <set-margins> 
command description in the 41 1 Series Command 
Reference Manual. Table 4-7 shows how the <set- 
margins> command might be used. 



Table 4-7 
USING THE <SET-MARGINS> COMMAND 



Command 


Effect 


<set-alphatext-size: 4,5,1 7> 


Selects a character size which 


< set-margins: 2> 


Is small enough to display two 




columns of 80 characters 




each, and sets the terminal to 




display alphatext in two col- 




umns. 


< set-alDhatext-size: 4.5.1 7> 


If the lines of text do not 


< set-margins: 3> 


exceed 54 characters, then al- 




phatext may be displayed In 




three columns without text 




from one column overprinting 




text in an adjacent column. 



The < set-margins> command may also be typed by 
the operator in SETUP mode; see the 41 1 4 Operator's 
Manual for details. 



THE DIALOG AREA 



INTRODUCTION 

The 41 1 4 provides a dialog area for displaying alpha- 
text without interfering with graphics drawn on the 
screen. The dialog area is like a scroll of text, part of 
which is displayed in a part of the screen called the 
dialog viewport. This text is displayed in refresh mode, 
so as not to interfere with storage mode graphics on 
the screen. 

The < enable-dialog-area> command controls whether 
or not alphatext is directed to the dialog area. 

< Enabie-dialog-area: 0> disables the dialog area; this 
makes the 41 1 4 compatible with software written for 
earlier TEKTRONIX terminals which lack a dialog area. 
With the dialog area disabled, alphatext is directed to 
the screen (graphics area) and may be used, for 
instance, as labels on graphs. 



< Enable-dialog-area: 1 > enables the dialog area and 
directs alphatext to the dialog area. The alphatext is 
stored in an internal memory buffer (the dialog scroll). 
The operator can display the dialog scroll contents by 
pressing the DIALOG key, which makes a portion of the 
dialog scroll visible on the screen. Likewise, the host 
can issue a <set-dialog-visibility> command to make 
the dialog scroll visible. 

When visible, the dialog area is displayed in refresh 
mode In a limited part of the screen called the dialog 
viewport. Using refresh mode avoids Interfering with 
graphics stored on the screen. Limiting the extent of 
the dialog viewport avoids overtaxing the terminal's 
refresh capability, (if too much text is displayed in 
refresh mode, the text will flicker.) 
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<ENABLE-DIALOG-AREA> COMMAND 

The < enable-dialog-area> command has the following 
syntax: 

< enable-dialog-area> = (ESC)(K)(A)<int> 

If the < int> is zero, the terminal emulates earlier 
TEKTRONIX terminals which lack a dialog area. Alpha- 
text and graphics are both sent to the same destination 
within the terminal: the main graphics display area. 

If the < int> is one, alphatext and graphics are sent to 
different destinations within the terminal. Graphics 
goes, as before, to the main graphics display area. 
Alphatext, however, is directed to the dialog scroll, 
regardless of whether that scroll is currently visible. To 
make the scroll visible, the DIALOG key or the < set- 
dialog-area-visibility> command must be used. 



The < enable-dialog-area> command affects the oper- 
ation of several other terminal features. With the dialog 
area disabled, these features emulate earlier 
TEKTRONIX terminals which lack a dialog area. With 
the dialog area enabled, these features operate in a 
way which is more appropriate for use with a dialog 
area. 

Table 4-8 lists the differences between operation with 
and without the dialog area enabled. For more details, 
see the descriptions in the 41 1 Series Command 
Reference Manual of the <enable-dialog-area> , <en- 
able-401 0-GIN> , < page> , and < renew-view> com- 
mands, and of the (CR) character. 



Table 4-8 
FEATURES AFFECTED BY THE < ENABLE-DIALOG- AREA> COMMAND 



Feature 


Effect With Dialog 
Area Disabled 


Effect With Dialog 
Area Enabled 


PAGE Key, 
<Page> Command 


Erases the screen. 

Redraws all visible segments. 

Exits the terminal from 401 GIN mode. 

Resets line style to line style 0. 

Resets the line width to 0. 

"Homes" the graphic beam. (X= 0, Y= 3071 .) 

Puts margin number 1 In effect. 

Puts the terminal In alpha mode. 


Erases the screen. 
Redraws all visible segments. 


< Renew-Vlew> 
Command 


Erases the screen. 
Redraws all visible segments. 


Erases the screen. 
Redraws all visible segments. 


(CR) Character 


Puts terminal in alpha mode. 

Performs "carriage return" action. 

Resets line style to line style 0. 

Resets line width to 0. 

Removes the terminal from 401 GIN mode. 


If In alpha mode, performs "carriage return" 
action for the alphatext cursor in the dialog area. 

If In vector or marker mode, does nothing. 
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< SET-DIALOG- AREA- VISIBILITY > 
COMMAND 

The <set-dialog-area-visibility> command determines 
whether text stored in the dialog scroll is visible to the 
terminal's operator. This command has the following 
syntax: 

<set-dialog-visibility> = (ESC){L)(V)<int> 

Here, the < int> is one to make the dialog area visible, 
or zero to make it invisible. 

When the terminal is turned on, the dialog area is 
visible only if the dialog area is enabled. (The terminal 
"remembers" whether the dialog area was enabled 
when it was turned off.) 

The operator can control dialog area visibility by the 
DIALOG key and the SETUP mode command DAViS. 
For more details, see the 41 1 4 Operator's Manual. 

SETTING DIALOG AREA SIZE AND 
POSITION 

When creating a dialog area, you set several parame- 
ters to control such things as its size and location. 
Each of the parameters has its own command. 

The < set-dialog-area-chars> command sets the width 
of the dialog viewport (number of characters per line). 

The <set-dialog-area-lines> command sets the height 
of the dialog viewport (number of lines of text which are 
visible at the same time). 

The < set-dialog-area-buffer-size > command sets the 
size of the internal memory which holds the dialog area 
scroll. 

The < set-dialog-area-position> command sets the 
position of the dialog viewport's lower left corner. 

The following commands show how to create a dialog 
area. For details on the syntax of these commands, see 
the 41 10 Series Command Reference Manual. 

< set-dialog-area-chars: 40> 

< set-dialog-area-lines: 10> 

< set-dlalog-area-buffer-size; 30> 

< set-dialog-area-position: (0,0) > 

< enable-dialog-area: 1 > 

< set-dialog-area-visibility: 1> 



Here, the dialog viewport will be 40 characters wide 
and 1 lines high. The dialog buffer size is made large 
enough to hold 1 200 alphatext characters. (That is 30 
full-size 40-character lines; if the lines are shorter, 
more lines can be stored in the dialog scroll.) The 
dialog viewport is positioned at the lower left corner of 
the screen. Finally, the <enable-dialog-area> 
command directs alphatext to the dialog area, and the 
<set-dialog-area-visibility> command makes the dia- 
log area visible to the operator. 

< SET-D!ALOG-AREA=WRIT!NG=MODE> 
COMMAND 

The < set-dialog-area-writing-mode> command deter- 
mines how text is displayed in the dialog area. There 
are two writing modes, "overstrike" mode and "re- 
place" mode. 

The command syntax is as follows: 
<set-dialog-area-writing-mode> = (ESC)(L)(M)<int> 

The < int> parameter Is zero for replace mode, and 
one for overstrike mode. 

The operator can also type this command in SETUP 
mode, using the SETUP mode keyword, DAMODE. See 
the 41 1 4 Operator's Manual for details. 
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USING THE OPTIONAL "APL" FONT 

If your 41 1 4 is equipped with Option 4E (the APL The character sequence (ESO(SO) causes the 

keyboard), then you may switch between two alphatext terminal to switch to the APL character font for 
fonts by means of the < set-alphatext-font> command: displaying alphatext. The character sequence 

< set-alphatext-font: standard> = (ESC) (SI) < ? 8 ° ,(8 ! ) A c 5 "f° s ^ terminal to switch back to the 

standard ASCII font. 

< set-alphatext-font: APL > = (ESO(SO) 

Figure 4-1 shows the standard ASCII font and the 
optional APL font. 



!"#$%&' < )*+,-. /01 23456789: ; <=>? 
@ABCDEFGHIJKLMNOPQRSTUVWXYZC\]~_ 
'abcdef ghi jklmnopqrstuvwxyz< I >~ 

A. STANDARD FONT. 

'" )<<=>]va?!*, +. /01 23456789( C ; x : \ 
~axnLe_VAi ♦ ' D I to*?p |"~ •^uco^Tc•«-l--»■>- 
B. APL FONT. 



3675-9 



Figure 4-1 . Standard and APL Character Fonts. 



CONTROL CHARACTERS 



The control characters, their keyboard equivalent, and 
how they are interpreted by the 41 1 4 are listed here. 
For further details, see the 41 1 Series Command 
Reference manual. 
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Table 2-1 
CONTROL CHARACTER EFFECT 



Control 



ACK 
BEL 
BS 

CAN 



CR 

0G1 

DC2 

DC3 

DC4 

OLE 

EM 

ENQ 



EOT 
ESC 

ETB 

ETX 
FF 



Keyboard 
Equivalent 



CONTROL F 

CONTROL G 

BACKSPACE OR 
CONTROL H 

CONTROL X 



RETURN OR 
CONTROL M 

CONTROL Q 

CONTROL R 

CONTROL S 

CONTROL T 

CONTROL P 

CONTROL Y 

CONTROL E 



CONTROL D 

ESC or SHIFT- 
CONTROL K 



CONTROL W 

CONTROL C 
CONTROL L 



4114 Terminal interpretation 



None. 

BEL character. 

Backspace character. 

As a second character in the ESC 
CAN sequence, it enables a 
Bypass Condition to inhibit 
terminal response to echoed data. 

Carriage return character. 

Flagging character. 

None. 

Flagging character. 

None. 

None. 

None. 

As a second character in the ESC 
ENQ sequence, this completes a 

< REPORT-41 1 0-STATUS> 
command. 

None. 

Starts all commands to the 
termninal of two or more 
characters. 

As a second character In the ESC 
ETB sequence, this completes a 
<411Q-HARDCOPY> command. 

None. 

As a second character in the ESC 
FF sequence, this completes a 

< PAGE> command. 



Con trol 

FS 

GS 

HT 
LF 
NAK 



Keyboard 
Equivalent 

SHIFT- 
CONTROL L 

SHIFT- 
CONTROL M 

TAB or 
CONTROL I 

LFor 
CONTROL J 

CONTROL U 



41 1 4 Terminal Interpretation 

This is a single-character 

< ENABLE-MARKER-MODE> 
command. 

This is the single-character 

< ENABLE-VECTOR-MODE> 
command. 

Horizontal tab character. 



Linefeed character. 



None. 



NUL 


SHIFT- 
CONTROL P 


None. 


RS 


SHIFT- 
CONTROL N 


None. 


S! 


CONTROL 


As a second character in the ESC 
SI sequence, this completes a 
< SET-ALPHATEXT-FONT> 
command. 


SO 


CONTROL N 


As a second character in the ESC 
SO sequence, this completes a 
< SET-ALPHATEXT-FONT> 
command. 


SOH 


CONTROL A 


None. 


STX 


CONTROL B 


None. 


SUB 


CONTROL Z 


As a second character in the ESC 
SUB sequence, this completes an 
<ENABLE-4110-GIN> 
command. 


SYN 


CONTROL V 


None. 


US 


SHIFT- 
CONTROL 


This Is the single-character 
< ENABLE-ALPHA MODE> 
command. 


VT 


CONTROL K 


Vertical tab character. 
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DISPLAYING GRAPHIC INFORMATION 



INTRODUCTION 



This section teiis how to make the 41 1 4 draw pictures 
on its screen. Topics discussed here are: 

• Terminal Space Coordinates. The coordinate system 
used to express the locations of graphic objects, 
and the <xy> coding scheme used to send terminal 
space coordinates to the 41 1 4. 



• Drawing Lines. How to draw line segments on the 
41 14's screen. 

• Attributes of Lines, varying how iines are dispiayed. 

• Markers. Displaying markers (small, standard graph- 
ic objects). 



TERMINAL SPACE COORDINATES 



Graphics in the 41 14 are drawn in so-called "terminal 
space." This is a discrete two-dimensional space in 
which x- and y-coordinates are integers in the range 
from to 4095. There are 1 6,777,21 6 addressable 
points in terminal space (4096 x 4096 = 1 6,777,21 6). 

When sending graphic coordinates to the terminal, x- 
and y-coordinates can range from to 4095. However, 
the screen is not square, so not all points in the 
square-shaped terminal space are visible. (Points with 
y-coordinates greater than about 31 50 fall outside the 
screen.) Only points in the range from x= to x= 4095, 
and from y= to y= 31 27, are guaranteed to be visible. 



XY PARAMETERS 

To send a pair of x- and y-coordinates to the terminal, 
you must encode them in a certain way. In this manual, 
the term <xy> refers to a pair of x- and y-coordinates 
as encoded for transmission to the terminal. The term 
<xy: (1 00,200)> refers to the coordinate pair 
(1 00,200), as encoded for transmission to the terminal. 
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FORMAT OF < XY> COORDINATE BYTES Order and Meaning of the < XY> Bytes 



Each <xy> parameter consists of from one to five 
ASCII characters (seven-bit bytes). The bytes are sent 
in this order: <HiY> <Extra> <LoY> <HiX> 
< LoX> . Figure 5-1 shows the formats of the 
five bytes. 



1 . The < HiY> (high-order y) byte comes first. This 
byte contains the most-significant five bits of the 
binary numeral representing the y-coordinate. 

01 yyyyy 

yyyyy : high-order five bits of the y-coordinate. 

You can omit the < HiY> byte if the high-order five 
bits of the y-coordinate have not changed since 
the last <xy> coordinate sent to the terminal. 



<xy: (52,1 000) > 



x-coordinate = decimal 52 
= binary 00000 01 101 00 



y-coordinate= decimal 1 000 
= binary 001 11 11010 00 



J 



<HiY> = 



01 



00111 



(') 



<Extra> = [77 



00 



00 



n 



<LoY> = 



11 



_£ 



11010 



<HiX> = 



01 



00000 



<LoX> 



<xy: (52,1000)> = C)(')(z)(SP)(M) 



10 



01101 



= (z) 



= (SP) 



(M) 
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Figure 5-1. Format of <XY> Bytes. 
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2. Next comes the < Extra> byte. This byte contains 
the least-significant two bits of the x-coordinate, 
and the least-significant two bits of the y-coordi- 
nate. 

1 1 ?yyxx 

? : "don't care" — may be either or 1 
yy : least-significant bits of y-coordinate 
xx : least-significant bits of x-coordinate 

You can omit the < Extra> byte if the least- 
significant bits of the x- and y-coordinates have 
not changed since the last <xy> coordinate sent 
to the terminal. If you do send the < Extra> byte, 
you must follow It with the < LoY> byte. 

3. Next comes the < LoY> (low-order y) byte. Despite 
its name, this byte contains the intermediate five 
bits of the 1 2-bit y-coordinate. 

1 1 yyyyy 

yyyyy : intermediate five bits of y-coordinate. 

You can omit the < LoY> byte provided: 

• you are sending neither the < Extra> byte nor 
the < HIX> byte In this <xy> coordinate, and 

• the intermediate five bits of the y-coordlnate 
have not changed since the last <xy> 
coordinate sent to the terminal. 

4. Next comes the < HiX> (high-order x) byte. This 
byte contains the high-order (most-significant) five 
bits of the x-coordinate. 

1 xxxxx 

xxxxx : most-significant five bits of x-coordinate. 

You can omit the < HiX> byte if the x-coordinate's 
most -significant bits have not changed since the 
last <xy> parameter sent to the terminal. If you do 
send the < HIX> byte, then you must precede It 
with the <LoY> byte. 



5. Finally comes the < LoX> (low-order x) byte. Again, 
despite its name, this byte contains the intermedi- 
ate five bits of the x-coordlnate. 

1 Oxxxxx 

xxxxx : intermediate five bits of x-coordinate. 

This byte is always required, because it serves to 
terminate the <xy> byte sequence. 

NOTE 

The < LoY> and < Extra> bytes each have high- 
order bits of 1 1. Thus the (DEL) character (binary 
1111111) Is a possible < LoY> or < Extra> byte. 
Since some host computers use (DEL) as a filler 
character, this could be a problem In some 
Installations. 

The 41 14 includes two features for overcoming 
this difficulty. First, it treats (ESCH?) as a syno- 
nym for the (DEL) character. Secondly, the 41 14 
can be set to Ignore (DEL) characters. (Use the 

< ignore-deletes> command described in the 
41 10 Series Command Reference Manual.) 

If your host computer uses (DEL) as a filler 
character, then you should use these features. 
Have the host send (ESC)(?) in place of 
(DEL) In <xy> parameters, and send an 

< ignore-deletes: 1> command to the terminal. 

See the 41 10 Series Command Reference Manual for 
more Information on sending < xy> parameters to the 
terminal. 
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<XY> Syntax Summary 

The following summarizes the formal syntax of <xy> 
coordinates: 

<xy> = [<HiY>] 

[[<Extra>]<LoY>l<HiX>]] 
<LoX> 

< HiY> = (SP) or (!) or (") or (#) or ($) or (%) or 

(&) or (') or ("(") or (")") or (*) or (+ ) or 
(,)or(-)or(.)or(/)or<0)or(1)or 
(2) or (3) or (4) or (5) or (6) or (7) or 
(8) or (9) or (:) or (;) or (< ) or (>) or 
(?). 

(ASCII characters with high-order bits 
"01"] 

< Extra> = (') or (a) or (b) or (c) or (d) or (e) or 

(f) or (g) or (h) or (i) or 0) or (k) or 
(I) or (m) or (n) or (o) or (p) or (q) or 
(r) or (s) or (t) or (u) or (v) or (w) or 
(x)or(y)or(z)or({)or(|)orfl)or 
(~)or(DEL)or(ESC)(?). 

{ASCII characters with high-order bits 
"11", and with (ESC)(?) as a synonym for 
(DEL) J 

< LoY> = (') or (a) or (b) or (c) or (d) or (e) or 

(f) or (g) or <h) or (i) or (j) or (k) or 
(I) or (m) or (n) or (o) or (p) or (q) or 
(r) or (s) or (t) or (u) or (v) or (w) or 
(x)or(y)or(z)or(()or(|)orO)or 
(~)or(DEL)or(ESC)(?). 

{ASCII characters with high-order bits 
"11", and with (ESC)(?) as a synonym for 
(DEL).] 



< HiX> = (SP) or (I) or (") or (#) or ($) or (%) or 

(&) or (') or ("(") or (")") or (*) or (+ ) or 
(,)or(-)or(.)or(/)or(0)or(1)or 
(2) or (3) or (4) or (5) or (6) or (7) or 
(8) or (9) or (:) or (;) or (<) or (>) or 
(?). 

{ASCII characters with high-order bits 
"01".) 

< LoX> = (<? ) or (A) or (B) or (C) or (D) or (D) or 

(F) or (G) or (H) or (I) or (J) or (K) or 
(L) or (M) or (N) or (O) or (P) or (Q) or 
(R) or (S) or (T) or (U) or (V) or (W) or 
(X) or (Y) or (Z) or (D or (\) or 0) or 
(A)or(_) 

{ASCII characters with high-order bits 
"10".} 

CONSIDERATIONS WHEN SENDING 
<XY> COORDINATES TO THE TERMINAL 

The terminal interprets <xy> coordinates correctly 
(rather than displaying them as alphatext) only if at 
least one of the following conditions is met: 

• The < xy> coordinate is sent as a parameter for an 
"escape sequence" command. 

• The terminal is in vector mode, having received an 

< enter-vector-mode> command (the (GS) charac- 
ter). 

• The terminal is in marker mode, having received an 

< enter-marker-mode> command (the (FS) 
character). 

The host program should, therefore, send <xy> coor- 
dinates to the terminal only when at least one of those 
conditions is met. 
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DRAWING LINES 



There are two ways to draw lines on the screen. One 
way is by putting the terminal in vector mode and then 
sending <xy> coordinates to it. Another way is by 
means of <move> and <draw> commands. 

VECTOR MODE 

As mentioned in Section 1 , the 41 1 4 has three main 
modes of operation: alpha mode, vector mode, and 
marker mode. When the terminal is in alpha mode, it 
interprets alphanumeric characters coming from the 
host as letters and symbols to be displayed. In vector 
and marker modes, however, such characters are 
interpreted as <xy> coordinates representing points 
in tormina! s n ace. In vector mode, the terminal draws 
lines ("vectors") between these points. 

Entering and Leaving Vector Mode 

The terminal can enter vector mode from alpha mode, 
but not from marker mode. Therefore, if the terminal is 
in marker mode, you must first place it in alpha mode. 
You do this by sending a (US) character, which 
comprises the < enter-alpha-mode> command. 

Once the terminal is in alpha mode, send the <enter- 
vector-mode> command: the single character, (GS). 

To remove the terminal from vector mode, send it an 
<enter-alpha-mode> command (the (US) character) 
or an < S nter-marker-mode> command (the (FS) 
character). 

The Graphic Beam Position 

The 41 1 4 maintains a pointer in Its memory to the 
current location in terminal space where it will display 
graphic Information. This pointer is called the graphic 
beam position. 



If the terminal is emulating earlier TEKTRONIX termi- 
nals which lack a dialog area (that is, if the dialog area 
is not enabled), then the graphic beam position also 
determines where alphatext will be displayed. (If the 
terminal enters alpha mode, the lower left corner of the 
next alphatext character will be at the graphic beam 
position.) 

If the terminal is not emulating earlier terminals (that is, 
if the diaiog area is enabled), then alphatext is directed 
to the current cursor location in the dialog area scroll. 
In that case, the graphic beam position has no effect on 
alphatext. 

Drawing Lines in Vector Mode 

Once the terminal is in vector mode, it interprets any 
ASCII characters in the range from (SP) to (DEL) - 
decimal equivalents from 32 to 1 27 — not as charac- 
ters to be displayed, but as < xy> parameters. 

While in vector mode, the terminal Ignores most of the 
ASCII control characters (characters with decimal 
equivalents less than 32). The exception? are: (ESC), 
which signals the start of a new command; (BEL), 
which sounds the terminal's bell and makes the next 
vector a draw; the (US) and (FS) characters, which 
comprise <enter-alpha-mode> and <enter-marker- 
mode> commands; and — sometimes — the (CR) 
character. If the terminal is emulating earlier TEKTRO- 
NIX terminals (dialog area disabled), then the (CR) 
character puts the terminai back into aipha mode, if the 
terminal is not emulating earlier TEKTRONIX terminals 
(dialog area enabled), then it Ignores any (CR) 
characters it receives while in vector mode. 
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Moving the Graphic Beam. While in vector mode, the 
terminal interprets an <xy> coming immediately after 
a (GS) character as a command to move the graphic 
beam to the point specified by the <xy> coordinates. 
The current graphic beam position is updated, but 
nothing is drawn on the screen. 

Drawing Lines. Any subsequent <xy> parameter, not 
immediately following a (GS), causes the terminal to 
draw a line from the current graphic beam position to 
the point specified by the <xy> parameter. The beam 
position is updated to refer to the point at the end of 
the line just drawn. 

The sequence (GS)(BEL)<xy> puts the terminal in 
vector mode, sounds the bell, and draws a line to the 
point specified by the < xy> coordinate. (This is 
described later in this section.) 

To make the terminal "lift its pen" (move the beam 
without drawing anything), send another (GS). An 
<xy> coming immediately after a (GS) moves the 
graphic beam, while <xy>s that follow draw lines to 
the corresponding points. 

An Example 

Figure 5-2 shows commands which draw a square with 
diagonals. Table 5-1 expands these commands Into the 
individual ASCII characters which are sent to the 
terminal. 



< enter— vector— mode> 
<xy: (0,0) > 

<xy: (2 00,0) > 
<xy: (200,200) > 
<xy: (0,200)> 
<xy: (0,0)> 
<xy: (200,200) > 

< enter —vector -mode > 
<xy: (0,200) > 

<xy: (200,0) > 



(0,200) 



(200,200) 




(0,0) 



(200,0) 



3675-11 



Figure 5-2. A Sample Figure Requiring "Moves" and 
"Draws." 



Table 5-1 


COMMAND8 TO DRAW A SQUARE 


WITH DIAGONALS 


Command 


Characters Sent 


< enter-vector-mode> 


(GS) 


<xy:(0,0)> 


(SP)tt«(SP)(,@,) 


<xy: (200,0) > 


W(I)(R) 


<xy: (200,200) > 


(l)(r)(R) 


<xy:(0,200)> 


(r)(SP)(@) 


<xy:(0,0)> 


(SPIOH® 1 ) 


<xy: (200,200) > 


(l)(r)(l)(R) 


< enter-vector-mode> 


(GS) 


< xy: (0,200) > 


(r)<SP)(@<) 


<xy : (200,0) > 


(SP)M(I)(R) 
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Draws Without Moves: (GSHBEL) 

There are times when you may want to put the terminal 
in vector mode and then immediately draw a vector 
from the current beam position to some point — despite 
the fact that you do not know exactly where the graphic 
beam is positioned. To do this, precede the first < xy> 
parameter with a (BEL) character. The (BEL) prepares 
the terminal for a "draw" without changing the current 
beam position. 

For example, in Figure 5-3 the graphic beam is moved 
to (0,1000), and an alphatext string is displayed there. 
Then a (GS)(BEL)<xy> sequence draws a line from 
where the next alphatext character would appear (if the 
terminal were to stay in alpha mode) to the point 
(2000,1000). (In this example, the <enable-dialog-area: 
0> command disables the dialog area. This ensures 
that the aiphatext is displayed together with the 
graphics, rather than being sent to the dialog area.) 



< enable— dialog— area: 0> 

< enter— vector— mode> 
<xy:(0,1000)> 

< enter— alpha - mode> 
(N)(a)(m)(e)(SP)(:)(SP) 

< enter— vector— mode> 
(BEL) 

<xy: (2000,1 000) > 



Name 
\ 



(0,1000) 



(2000,1000/ 



3675-1 2 A 



<MOVE> AND <DRAW> COMMANDS 

Another way to draw lines is with the < move> and 
<draw> commands. These commands have the fol- 
lowing syntax: 

<move> = (ESC)(L)(F)<xy> 

<draw> = (ESC)(L)(G)<xy> 

The < move> command moves the graphic beam 
position to the point specified in its <xy> parameter. 
The <draw> command draws a line from the current 
graphic beam position to the point specified in its 
<xy> parameter. 

Note that the <draw> command is like the 
(GS)(BEL)<xy> construct in that it causes an immedi- 
ate draw from any location. 

These commands do not change the terminal's operat- 
ing mode, if the terminal is in aipha mode when it 
receives a < move> or < draw> command, then it is 
still in alpha mode after the command has been 
executed. Likewise, if the terminal is in vector mode or 
marker mode on receiving a < move> or < draw> , 
then it is in that mode after executing the command. 



Figure 5-3. A "Draw" Without a Preceding "Move." 
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ATTRIBUTES OF LINES 



LINE STYLE 

You can draw lines in different line styles: solid, 
dashed, etc. To do this, send the terminal a <set-line- 
style> command before drawing the lines. After that 
command, all subsequent lines are drawn in the line 
style specified by the command. 

< Set-Line-Style> Command 

The <set-line-style> command has the following 
syntax: 

<set-line-style> = <ESC)(M)(V)<int> 

Figure 5-4 shows examples of the different line styles. 

<Set-Llne-Wldth> Command 

The <set-line-width> command lets you defocus the 
41 14's electron beam, so that it draws lines which are 
thicker than normal. The command has the following 
syntax: 

<set-line-width> = (ESCMM)(W)<int> 

The < int> parameter is zero for normal width lines 
and one for broad (defocused) lines. 



<Set-4014-Line-Style> Command 

The <set-4014-line-style> command is included for 
compatibility with software written for earlier TEKTRO- 
NIX terminals. This command combines the capabilities 
of the <set-line-style> and <set-line-width> 
commands. See the 41 1 Series Command Reference 
Manual for details. 

LINE INDEX 

TWfl ** e*»+ tins i •* fi ** v *v_ *"» ** *"* ™ « P» *i Mllmtm linn t«* *H*»MMt{>> 

i i*o v. Scu-iii i6-iiiuoA> ouiiniianu aiiuAo yuu iu 5|j@wi7y 

a "line index" for use when drawing subsequent lines. 
The line index does not affect how the line is displayed 
on the 41 1 4's screen. However, it does affect how the 
line is drawn on an accessory plotter when a < plot> 
command is executed. (The < plot> command is 
described in the 41 10 Series Command Reference 
Manual.) 
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<set- 


line— style: 0> 


< enter— vector— mode> 


<xy: 


(100,100)> 


<xy: 


(1000,1 00) > 


<set- 


line— style: 1 > 


<ente 


r— vector— mode> 


<xy: 


(1 00,300) > 


<xy: 


(1 000,300) > 


<set- 


line— style: 2> 


< ente 


■—vector— mode> 


<xy: 


(1 00,500) > 


<xy: 


(1 000,300) > 


<set- 


line— style: 7> 


<ente 


•—vector— mode> 


<xy: 


(100,1 500) > 


<xy: 


(1000,1 500) > 



(100,1500) 



(1000,1500) 



Line Style 



(100,100) 



(1000,100) 



3675-13 



Figure 5-4. Line Styles Available In the 41 1 4. 
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MARKERS 



Markers are small, predefined, graphic shapes which 
the 41 1 4 can display anywhere in its 4096-by-4096 
"terminal space." You can display them in two ways: by 
putting the terminal in marker mode and sending 

< xy> coordinates, or by issuing individual < draw- 
marker commands for each marker to be displayed. 

MARKER MODE 

One way to display markers is as follows: 

1 . Select the marker type to be displayed. To do this, 
send the terminal a <set-marker-type> command. 

2. Send an <enter-marker-mode> command to the 
terminal. (This is just the single ASCII character 
(FS).) 

3. Send the terminal an <xy> coordinate for each 
marker to be displayed. 

4. When done, issue an <enter-alpha-mode> com- 
mand — the (US) character — to remove the 
terminal from marker mode. 

< Set -Marker-Type > Command 

The < set-marker-type> command has the following 
syntax: 

< set-marker-type> = (ESC)(M)(M)<int> 

Here, the < int> parameter may be in the range from 
zero to ten to select any of eleven predefined markers 
provided with the 41 14. 



Entering and Leaving Marker Mode 

To put the terminal in marker mode, send it an (FS) 
character; this comprises the < enter-marker-mode> 
command. 

While the terminal is in marker mode, (GS) characters 
(<enter-vector-mode> commands) have no effect. 
Therefore, the only way to remove the terminal from 
marker mode is to place it in alpha mode. This is 
usually done by sending a (US) character, which 
comprises the < enter-alpha-mode> command. 

Example 

Figure 5-5 shows commands which cause the terminal 
to display markers in each of the eleven predefined 
marker types. 



THE<DRAW-MARKER> COMMAND 

Another way to display a marker is to send the terminal 
a < draw-marker> command: 

< draw-marker> = (ESC)(L)(H)<xy> 

This causes the terminal to display one marker, of the 
current marker type, at the position specified by the 
command's <xy> parameter. The graphic beam posi- 
tion is updated to the position specified by the <xy> 
coordinate. 

When the terminal has finished executing the <draw- 
marker> command, it returns to the mode it was In 
before executing that command. For instance, if the 
terminal was in alpha mode when it received the 

< draw-marker> command, then it is In alpha mode 
after displaying the marker, and likewise for vector and 
marker modes. 
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<set— marker— type: 0> 








Marker Type 




< enter— marker— mode> 












<xy:(100,1200)> 













<xy: (200,1 200) > 








1 




<xy: (300,1 200)> 












<set— marker— type: 1> 


+ 


+ 


+ 


2 




<xy:(100,1100)> 








3 




<xy: (200,11 00) > 


* 


* 


* 




<xy: (300,11 00) > 


G 








4 




<set— marker— type: 2> 












<xy: (100,1 000) > 


X 


X 


X 


5 




<xy: (200,1 000) > 


G 


□ 


□ 


6 




<xy: (300,1 000) > 












• 


O 


o 


c> 


7 






B 


a 


B 


8 




<set— marker— type: 10> 


<i> 


<?> 


<» 


9 




<xy: (100,1 00) > 












<xy: (200,1 00) > 


S 


s 


S 


10 




<xy: (300,1 00)> 












< enter— alpha— mode > 

i 
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Figure 5-5. Displaying Markers. 
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Section 6 



SEGMENTS 



INTRODUCTION 



DEFINITIONS 
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objects which can be manipulated by commands to the 
terminal. Each segment is referenced by its name, 
which is a number in the range from 1 to 32767. 

For instance, suppose segment one has been defined 
to be a square with diagonals. Once segment one has 
been defined, you can issue commands to change its 
appearance and position. You can rotate and seals it 
about its "pivot point," move it from one position to 
another in terminal space, make it invisible ("turn it 
off"), cause it to "blink" on and off, and even use it as 
the graphic cursor for GIN (graphic input) operations. 

Each segment has a pivot point, which is set at the time 
the segment is created. It is the pivot point within a 
segment which serves to define the segment's position. 
Thus, a < set-segment-position > command to position 
segment one at the point (1 00,500) actually positions 
only the pivot point for that segment at the point 
(100,500). 

The pivot point is also the point about which scaling 
and rotation occurs. These operations are described 
later, under "Scaling and Rotation." 

CREATING A SEGMENT 

The < begin-segment> and < end-segment> com- 
mands mark the beginning and end of a segment 
definition. The syntax for these commands is as 
follows: 

< begln-segment> = (ESCMSMO) 

< Int: segment-number> 

< end-segment> = (ESCMSMO 



Figure 6-1 shows commands which create a simple 
segment. (All these commands are described in more 
detail In the 41 1 Series Command Reference Manual.) 

This segment, segment one, is a square with diagonals, 
200 units on aside. Its pivot point is at (100,1 00), the 
center of the square, where the diagonals intersect. 



<set-pivot-point: (100,100)> 

< delete— segment: 1> 

< begin— segment: 1> 

< enter— vector— mode > 
<xy: (0,0) > 

<xy: (200,0) > 
<xy: (200,200) > 
<xy: (0,200) > 
<xy: (0,0) > 
<xy: (200,200) > 

< enter— vector— mode> 
<xy: (0,200) > 

<xy: (200,0) > 

< end— segment > 



(0,200) 



(200,200/ 




(0,0) 



(200,0) 



3675-15 



Figure 6-1 . Segment One, A Square With Diagonal*. 
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In Figure 6-1 , the < set-pivot-point> command is 
issued before the < begin-segment> command. This is 
necessary because, once a segment has been defined, 
its pivot point cannot be changed. A <set-pivot-point> 
command, therefore, affects only the pivot points of 
segments which are defined after that <set-pivot- 
point> command. 

The < delete-segment> command deletes any "seg- 
ment one" which might already exist. This is necessary 
because one cannot create a new segment with a 
segment number equal to that of an existing segment. 

If segment one does not exist, and the terminal's error 
threshold is set to one or less, then the < delete- 
segment> command causes the terminal to display a 
type SK1 warning message: "Existence Problem in 
Parameter 1 of (ESC)(S)(K) Command." You can sup- 
press this message by setting the error threshold to 2 
or more. For details, see the description of the < set- 
error-threshold> command in the 41 1 Series 
Command Reference Manual; see also Appendix C, 
"Error Codes," in that manual. 

The <begin-segment> and < end-segment> com- 
mands begin and end the segment definition. Any 
commands which occur between those two commands 
are included in the definition of the segment. Figure 6-1 
has < enter-vector-mode> commands and <xy> 
coordinates which perform moves and draws to create 
the square and its two diagonals. 

See the 41 1 Series Command Reference Manual for 
detailed descriptions of the < set-pivot-point> , 
< begin-segment> , < end-segment> , and < delete- 
segment> commands. There you will find the details of 
the command syntax, which you can use to write 
subroutines to issue these commands. 

The <begin-higher-segment> command provides an alter- 
nate method for creating segments. This command closes 
the segment currently being defined and begins a new seg- 
ment with a segment number that is one greater than the 
segment just closed. The pivot point and position of the new 
segment is set to the current beam position. The < begin- 
higher-segment > command does the work of several com- 
mands. Note that a segment must be in the process of being 
defined when this command is issued. The current pivot 
point and default segment position are not changed by this 
command. 

The <begin-lower-segment> command works like the 
< begin-higher-segment > command except that segment 
number decreases by one, rather than increases. 



The <begin-new-segment> command also works similarly 
to the < begin-higher-segment > command. Rather than in- 
crementing the segment number by one, < begin-new- 
segment > lets you specify a segment number for the new 
segment. 

INCLUDING OTHER SEGMENTS IN A 
SEGMENT DEFINITION 

When defining a segment, you can include a copy of 
another segment in the segment definition. To do this, 
use the < inciude-copy-of-segment> command: 

< include-copy-of-segment> 

This command causes an image of the specified 
segment, in its current position, to be included as part 
of the segment being defined. 

Figure 6-2 illustrates the process. In the figure, < set- 
segment-position > and < set-segment-image-trans- 
form > commands are used to reposition segment one 
before inluding copies of segment one in the definition 
of segment two. The < set-segment-position > and 
< set -segment-image-transform > commands are de- 
scribed later in this section. 

RETAINED AND NON-RETAINED 
SEGMENTS 

In the computer graphics literature, you may find the 
terms retained segment and non-retained segment. 
Retained segments are segments which are retained in 
memory (by the host computer or by the terminal) after 
they have been drawn. All the 41 1 4's segments are 
retained segments. 

The so-called non-retained segment consists of all 
graphics which are drawn but are not retained. For the 
41 14, this is everything not included within the defini- 
tion of a numbered segment. 

Graphics not stored in segments (that is, graphics in 
the so-called non-retained segment) are lost whenever 
a < page> or < renew-view> command (or the PAGE 
key) erases the screen. 
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<begin-segment: 2> 
< set-line-style: 2> 

< enter- vector— mode> 
<xy: (0,0)> 

<xy: (2000,1 000) > 

<xy: (1 000,3000) > 

<xy: (0,0)> 
<set-segment-posltlon: 1 ,(2000,1 000)> 
<lnclude-copy-of-segment: 1> 

< set-segment-position: 1 ,(1 000,3000)> 

< Include— copy— of— segment: 1> 

<set-segmem-lmafe-traRSfonn: 1 ,2.0,2.0,30.0,(3000,3000); 
<lnclude-copy-of-segment: 1> 
<set-segment-posltlon: 1 ,(2500,2500) > 

< Include- copy— of— segment: 1> 
< end— segment > 



(1000,3000) ~ 





(3000,3000) 
(2500,2500) 



-(2000,1000) 



/.ji^— (0,0) 



3875-16 



Figure 6-2. Including One Segment In the Definition of Another. 



Graphics stored In segments, however, are not lost 
when a < page> occurs. Instead, after erasing the 
screen, the terminal redraws all graphics stored In 
visible segments. (If you want a segment to disappear 
when you erase the screen, you can make It Invisible 
with the < set-segment- visibility > command, de- 
scribed later in this section. Or, you can delete the 
segment — issue a <delete-segment> command J 



STATIC AND DYNAMIC ATTRIBUTES 

Those attributes, or properties, of a segment which 
cannot be changed once the segment has been defined 
are called static attributes of the segment. Those 
attributes which can be changed after segment defini- 
tion are called dynamic segment attributes. 
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PIVOT POINT 

There is just one static segment attribute: the pivot 
point. Once a segment has been defined, its pivot point 
cannot be changed. (To set a segment's pivot point, you 
must issue the <set-pivot-point> command before 
defining the segment. A < set-pivot-point> command 
issued after the segment is defined affects only 
segments defined later.) 

The pivot point is important when moving a segment: 
changing its position in terminal space, rotating it, or 
changing its size. A segment's "position" is defined by 
the position of its pivot point. Also, the pivot point is the 
only point of the segment which does not move when 
the segment is scaled in the x- and y-directions or 
rotated. These operations are described later in this 
section, under "Position" and "Scaling and Rotation." 
They are also described in the Command Reference 
Manual, under the < set-segment-position > and <set- 
segment-image-transform> commands. 

PRIMITIVE ATTRIBUTES 

A segment's pivot point, however, is not the only thing 
about a segment which is static. All graphic primitives 
within a segment (lines, graphtext font, graphtext size, 
alphatext font, etc.) are static, unchangeable parts of 
the segment. That is, once a segment has been created, 
it cannot be edited; it can only be deleted and defined 
again. 

Any attributes of the graphic primitives within a 
segment are also static and unchangeable. For 
instance, the lines within a segment are graphic 
primitives; the line styles used to draw those lines are 
attributes of those lines. Thus, if a segment is defined 
with its lines drawn in line style two (dashed lines), 
then it will always be drawn with its lines in that style. 

Again, graphtext within a segment is deemed to be a 
graphic primitive. The graphtext font and graphtext size 
are attributes of the graphtext graphic primitive. As 
primitive attributes, they are static, unchangeable parts 
of the segment. Thus, If a segment is defined with 
graphtext In a certain graphtext font and a certain size, 
then it will always be drawn with that graphtext in that 
font and that style. 

Table 6-1 lists the graphic primitives and their primitive 
attributes, together with the commands which embed 
those primitives and primitive attributes in a segment. 
Once a segment has been defined, the primitives and 
primitive attributes In Table 8-1 are static, unchange- 
able parts of the segment. 



Table 6-1 
GRAPHIC PRIMITIVES AND PRIMITIVE ATTRIBUTES 



Graphic 
Primitives 


Primitive 
Attributes 


Related 
Commands 


Lines 




< Enter-vector- 
mode> , < xy > , 

< Move> , < Draw> 




Line Style 


< Set-line-8tyle> 




Line Index 


< Set-llne-index> 




Line Width 


< Set-llne-wldth> 


Graphtext 




<Graphic-text> 




Graphtext size 


< Set-graphtext- 
size> 




Graphtext font 


< Set-graphtext- 
font> 




Graphtext precision 


<Set-graphtext- 
preclslon> 




Graphtext rotation 


<Set-graphtext- 
rotatlon> 




Text index 


<Set-text-lndex> 


Alphatext 




<Enter-alpha- 
mode> 




Alphatext size 


<Set-alphatext- 
size>,<Set-4014- 
alphatext-aize> 
text-size> 




Alphatext font 


< Set-alphatext- 
font> 




Text Index 


<Set-text-lndex> 


Markers 





< Enter-marker- 
mode>,<xy> 




Marker type 


< Set-marker-type> 




Line Index 


<Set-llne-lndex> 
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Information about the commands in Table 6-1 can be 
found, in alphabetical order, in the 41 1 Series Com- 
mand Reference Manual, Descriptions of the com- 
mands can also be found in various sections of this 
manual: 

Section 4: < set-alphatext-font> 

< set-alphatext-size> 

< set-401 4-alphatext-size> 



Section 5 : < enter-vector-mode> 

< mcve> 

< draw> 

< set-llne-style> 

Section 7: <graphic-text> 

< set-graphtext-font> 

< set-graphtext-size> 

< set-graphtext-rotation> 

< set-graphtext-precislon> 



DYNAMIC SEGMENT ATTRIBUTES 



The dynamic attributes of a segment are those attri- 
butes, or qualities, which can be changed after the 
segment is defined. These attributes are: position, 
scale factors, rotation, visibility, writing mode, highlight- 
ing, detectability, display priority, and segment class. 

POSITION 

When a segment is defined, its "position" is the same 
location in the terminal's 4096-by-4096 coordinate 
space as its pivot point. In the example earlier in this 
section, segment one was a square with diagonals, 
defined with the pivot point at the center of the square 
- the point (1 00,1 00). Thus, the initial position of 
segment one is also the point (1 00,1 00). 



The <set-segment-position> command moves the 
segment so that its pivot point Is displayed at some 
new position. (If the segment was originally drawn in 
storage mode, then the oid image remains on the 
screen. When a < page> command — or the PAGE key 
— erases the screen, the segment is redisplayed at Its 
current position; the screen erasure eliminates the old 
image.) 

The < set-segment-position > command has the 
following syntax: 

<set-segment-position> = (ESC)(S)(X)<xy> 

Here, the <xy> parameter names the point in terminal 
space where the segment's pivot point Is to be 
displayed. 
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Figure 6-3 demonstrates the < set-segment-position > 
command. In Part A of the figure, the segment is 
defined with the pivot point at (100,100). In Part B, the 



segment is moved so that the pivot point Is displayed at 
(1 000,1 000); then the screen is erased (< page> 
command) in order to eliminate the old image. 



< set-pivot-point: (100,100)> ¥-AXiS 


<delete-segment: 1> 


i. 


<begin-segment: 1> 




< enter— vector— mode> 




<xy: (0,0) > 




<xy: (200,0) > 




<xy: (200,200) > 




<xy: (0,200)> 




<xy: (0,0)> 




<xy: (200,200)> 




< enter— vector— mode> 




<xy: (0,200)> 




<xy: (200,0)> 




< end— segment > 


* 


n 00.1005 


"^ ^ ~ - — — — -*- X-AXIS 



A. Defining a Segment. 



< set —segment— position: 1 ,(1 000,1 000) > 
<page> 



■AXIS 



(1 000,1 000)- 




(0,0? 



■■*•■ X-AXiS 



B. Repositioning the Segment. 



3676-17 



Figure 6-3. Effect of the <8et-8*gimnt-Potltlon> Command. 
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Figure 6-4 shows what happens when you move a 
segment to the edge of the screen. That part of the 



segment which is to the left of X= (or to the right of 
X= 4095) Is not displayed. 



< set-pivot-point: (100,100)> 

< delete— segment: 1> 

< begin— segment: 1> 

< enter— vector— mode > 
<xy: (0,0) > 

<xy; (200 Q)> 
<xy: (200,200) > 
<xy: (0,200) > 
<xy: (0,0)> 
<xy: (200,200)> 

< enter— vector— mode > 
<xy: (0,200) > 

<xy: (200,0) > 
<end— segment > 



Y-AXIS 




(100.100) 



-*~X-AXiS 



A. Defining a Segment. 



<set— segment— position: 1,(0,0)> 
<page> 



Y-AXiS 



The part of the segment to the 
left of x=0 is not displayed. 




(0,05 



-*- X-AXIS 



3675-18 



B. Repositioning the Segment. 



Figure 6-4. Positioning a Segment at the Edge of the Screen. 
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SCALING AND ROTATION 

The < set-segment-image-transform > command per- 
forms three operations on a segment: scaling, rotation, 
and positioning. The syntax of this command is as 
follows: 

< set-segment-image-transform> 

= (ESC) (SMI) <int><realxrealxreal><xy> 

Here, the first parameter is an < int> specifying the 
segment number, the second and third parameters are 
the x- and y-scaling factors, the fourth parameter is the 
rotation angle in degrees, and the fifth parameter 
specifies the point at which the segment is positioned 
after the scaling and rotation has been performed. 

First, the segment is scaled in the x- and y-directions 
about its pivot point. That is, the pivot point is the 
invariant point for the scaling operation — the only 
point which does not "move" because of the x- and y- 
scaling. 

Second, the segment is rotated about its pivot point by 
the number of degrees given in the "rotation" parame- 
ter. 

Finally, the segment is positioned (translated) so that 
its pivot point is displayed in the location specified by 
the final < xy> parameter. (If you only want to change 
a segment's position without affecting the other image 
transform parameters, use the < set-segment- 
posltion> command rather than the < set-segment- 
image-transform > command.) 

All three operations begin with the segment as it was 
originally defined. That is, they are "absolute" rather 
than "relative" operations. 

Examples 

Figure 6-5 shows commands which do the following, 
and the effects of those commands: 

1 . Define a segment: segment one, a square of side 
200 with diagonals, pivot point at (1 00,1 00). 

2. Scale segment one in the x-direction by a factor of 
three, and position it at Its original position: 

(1 00,100). Then page the screen to remove the old 
image of the segment. 

3. Scale segment one In the y-direction by a factor of 
three, move It to (1 000,1 000), and then page the 
screen to remove the old Image. 



Figure 6-6 shows more examples, continuing from 
those of Figure 6-5: 

4. Scale segment one in the x-direction by a factor of 
2.0 and in the y-direction by a factor of 3.0; rotate 
it counterclockwise by 30 degrees; position it at 
(1000,1000). Then erase the screen to remove the 
old image. 

5. Scale segment one in the x-direction by a factor of 
0.0 and in the y-direction by a factor of 4.0; rotate 
it clockwise by 30 degrees (counter-clockwise by 
-30 degrees); position it at (1000,1 000). Then 
erase the screen to remove the old image. 

VISIBILITY 

You can make a segment visible or invisible with the 

< set-segment-visibility> command: 

< set-segment-vislblllty> = (ESC)(S)(V)< lnt> < int> 

Here, the first < int> is the segment number. The 
second < int> is one to make the segment visible, or 
zero to make the segment Invisible. An invisible 
segment is retained in memory but is not redisplayed 
when the screen is erased. 

For more details, see the description of the <set- 
segment-visibility> command in the 41 10 Series Com- 
mand Reference Manual. 

WRITING MODE 

The < set-segment-writing-mode> command lets you 
control whether a segment is to be displayed in storage 
mode on the direct view storage tube, or in refresh 
mode. The command has this syntax: 

< set-segment-writlng-mode> 
= (ESC)(S)(M)<lntxlnt> 

Here, the first < int> is the segment number, while the 
second < int> specifies the writing mode: one for 
storage mode, or two for refresh mode. 

For more details, see the description In the 41 10 Series 
Command Reference Manual of the < set-segment- 
wrltlng-mode> command. 
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<set-plvot-point: (100,100)> 

< delete— segment: 1> 

< begin— segment: 1> 

< enter- vector- mode > 



<xy: 


(0,0)> 


<xy: 


(200,0) > 


<xy: 


(200,200) > 


<xy: 


(0,200) > 


<xy: 


(0,0)> 


<xy: 


(200,200) > 


< enter 


—vector— mode> 


<xy: 


(0,200) > 


<xy: 


(200,0) > 


end— segment > 



Y-AXIS 




(100,100) 



X-AXIS 



< set-segment-lmage-transform: 1 ,3.0,1 .0,0.0,(1 00,1 00)> 

< page> 



Y-AXIS 




(100,100) 



X-AXIS 



< set— segment— Image—transform: 1 ,1 .0,3.0,0.0,(1 000,1 000)> 
<page> 



Y-AXIS 



(1000,1000) 




X-AXIS 



S97J.W 



Figure 6-5. Examples of < Set-S e g m e n t-Image- Transform > Command. 
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<set— segment— image-transform: 1,2, 0,3. 0,30.0, (1000,1 000)> 
< page > 



Y-AXIS 



(1000,1000) 




< set-segment-image-transform: 1 ,0.0,4.0,-30.0,(1000,1 000)> 

< page> 



Y-AXIS 

1 1 



(1000,1000) 



-+- X-AXIS 




-+- X-AXIS 



3875-20 



Figure 6-6. Mora Examples of < Set-Segment-Image- Transform>. 
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HIGHLIGHTING 

You can draw the operator's attention to a segment by 
causing it to "blink" on and off (alternately become 
visible and invisible). To do this, use the < set- 
segment-highlighting> command: 

< set-segment-highlightlng> 
= (ESC)(S)(H)<intxint> 

Here, the first < int> is the segment number. The 
second < int> is one if the segment is to be highlight- 
ed zero if the highlighting feature is to be turned off. 

Highlighting is especially effective if the segment is 
displayed in refresh mode. 

For more details, see the description in Section 9 of the 

< set-segment-highlighting> command. 

DETECTABILITY 

A segment's "detectability" attribute determines 
whether or not the segment can be "picked" during a 
graphic input "pick" operation. For more details, see 
Section 8, which describes graphic input; see also the 
descriptions of the <enable-GIN> and < set-segment- 
detectability> commands In the 41 1 Series Com- 
mand Reference Manual. 

The < set-segment-detectability> command has this 
syntax: 

< set-segment-detectabillty> 
= (ESC)(S)(D)<intxint> 

The first < int> parameter is the segment number. The 
second < int> is one if the segment is to detectable 
(pickable), and zero if It is not to be detectable. 



DISPLAY PRIORITY 

A segment's "display priority" is a number which 
determines the order in which segments are redrawn 
when the screen is erased and the order in which 
segments are traversed during a graphic input "pick" 
operation. The display priority may be any integer in 
the range from —32768 to + 32767. On power-up, the 
default display priority for new segments is zero. 

When segments are redrawn after the screen is erased, 
segments with high display priority are drawn before 
those with lower priority. 

During a graphic input pick operation, the highest- 
priority segments are examined first. That way, if parts 
of several segments fail within the pick aperture, the 
highest-priority segment is the one which is picked. 

The < set-segment-display-priority> command has 
this syntax: 

< set-segment-dlsplay-priority> 
= (ESC)(S)(S)<intxint> 

The first < int> parameter is the segment number. The 
second parameter is the display priority. 
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SPECIAL SEGMENT NUMBERS 



All the segments which you define (with the < begin- 
segment> and <end-segment> commands) must 
have segment numbers in the range from 1 to 32767. 
However, in the commands which change the dynamic 
attributes of segments, you can use four other special 
segment numbers: 0, —1, —2, and —3. 

SEGMENT ZERO 

"Segment Zero" is the crosshair graphics cursor. The 
crosshair cursor is generated by special circuitry 
within the terminal, snu you cannot manipulate it in an 
the ways that other segments can be manipulated. You 
can move the crosshair cursor by specifying segment 
zero in the <set-segment-position> command. How- 
ever, you cannot rotate or scale the crosshair cursor, 
so "segment zero" is not allowed as a parameter in the 
<set-segment-image-transform> command. To see 
whether segment number zero is allowed for a particu- 
lar command, refer to that command's description in 
the 41 1 Series Command Reference Manual. 



SEGMENT MINUS ONE 

"Segment Minus One" means "all segments currently 
defined." (That is, all segments with numbers from 1 to 
32767; segment zero is not included.) For instance, 
you can make all segments invisible by specifying 
segment minus one in a <set-segment-visibility> 
command: 

< set-segment-visibility: — 1 , 0> 

Likewise, you can position all segments at a given 
point, force all segments to be displayed in storage 
mode, and highlight all segments: 

< set-segment-position: —1, (1 000,1 000)> 

< set-segment-writing-mode: — 1 , 1 > 

< set-segment-highlighting: — 1,1> 

No doubt other examples will occur to you. To see 
whether "segment minus one" is allowed as a parame- 
ter for a particular command, see that command's 
description in the 41 10 Series Command Reference 
Manual. 

NOTE 

Commands to change the attributes of "segment 
— 1" are not allowed if any segment is currently 
being defined, 



SEGMENT MINUS TWO 

"Segment Minus Two" means "the default for all 
segments not yet defined." That is, if you want to 
control a segment's visibility, or writing mode, or 
whatever, even before that segment is created, you can 
use a command specifying segment minus two before 
the < begin-segment> command which starts the 
definition of that segment. 

For example, the following commands cause a segment 
to be defined and to be displayed only after the 
segment definition is complete: 

< set-segment-visibility: — 2, 0> 

< begin-segment: 1> 

< enter-vector-mode> 
<xy> 
<xy> 



< enter-vector-mode> 
<xy> 
<xy> 



< end-segment> 

< set -segment-visibility: 1, 1> 

Using "segment minus two," you can specify default 
values (for new segments) of the following dynamic 
segment attributes: detectability, display priority, 
highlighting, visibility, position, and writing mode. (You 
can also set the "segment classes" to which new 
segments belong; this section discusses "segment 
classes" later in more detail.) 

SEGMENT MINUS THREE 

"Segment Minus Three" means "all segments in the 
current segment matching class." 

To understand "current segment matching class," you 
must understand the concept of "segment classes," 
which is the next topic in this section. 
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SEGMENT CLASSES 



INTRODUCTION 

You can classify segments into as many as 64 different 
"segment classes" or sets of segments. (The segment 
classes are numbered from 1 to 64.) 

Once you have put segments in those classes, you can 
manipulate whole classes of segments with only a few 
commands, rather than issuing separate commands to 
manipulate every one of the affected segments. 

For example, you can make all segments in class 1 3 
invisible. Or, you can highlight all segments which 
belong to class 1 and class 2, but do not belong to 
class 3. 

In a electronic drafting application, segment class 1 
might include aii segments which represent resistors. 
Segment class 2 might include ail the segments 
representing capacitors. Segment class 9 might in- 
clude all segments representing "new" components 
(components added during the last engineering 
change). 

You might then issue a command to set the "current 
segment matching class" to include all segments 
representing resistors added during the last engineer- 
ing change. This would be a < set-current-matching- 
class> command specifying that "segment —3" 
means "all segments which belong to segment class 1 
and also belong to segment class 9." 

With the "current segment matching class" set that 
way, you could then issue a command to highlight all 
segments in the current matching class (that is, to 
highlight all resistors added during the last engineering 
change). This would be a < set-segment-highlighting: 
—3, 1 > command. 



PROCEDURE FOR USING SEGMENT 
CLASSES 

To use the terminal's "segment class" features, do the 
following: 

1 . Use the < set-segment-class> command to assign 
segments to segment classes. Each segment class 
includes exactly those segments which have been 
assigned to it with the < set-segment-class> 
command. There may be as many as 64 segment 
classes, numbered from 1 to 64. 

2. Use the <set-current-matching-class> command 
to define the segment matching class. The current 
matching class is defined in terms of other (num- 
bered) segment classes. (You cannot place a 
segment directly in the matching class; however, 
you can place it in a numbered class, and then 
define the segment matching class so as to include 
all segments in that numbered segment class.) 

3. In commands to set segment attributes, you can 
refer to all segments in the current matching class 
by using the special segment number, —3. 

< SET-SEGMENT-CLASS> 
COMMAND 

To place a segment in a segment class (or remove it 
from a segment class), you use the < set-segment- 
class> command. This command has the following 
syntax: 

< set-segment-class> 

= (ESO(SMA) < intx int-arrayx int-array> 

The first parameter, an < int> parameter, is the 
segment number. 

The second parameter, an < lnt-array> , is the "removal 
array." It lists the segment classes from which the 
specified segment is to be removed. 

The third parameter, another < lnt-array> , Is the 
"addition array." It lists the segment classes to which 
the specified segment is to be added. 

The operation of the < set-segment-class> command 
Is as follows. The segment specified In the first 
parameter Is removed from (made a non-member of) all 
the segment classes listed In the removal array. Once 
that is done, the segment is added to (made a member 
of) all the classes listed In the addition array. 
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For instance, to make segment one a member of 
exactly classes 1 , 5, and 7, you could issue the 
following command: 

< set-segment-class: 1, (—1), (1,5,7)> 

= (ESC)(S)(A)<int:1> 

<int-array: (-1)> <int-array: (1,5,7)> 

= (ESC)(S)(A)(1)(1)(!)(3)(1)(5)(7) 

Here, segment one is first removed from "segment 
class — 1 ," that is, from all segment classes. Then it is 
made a member of segment classes 1 , 5, and 7. 

If you want to remove segment one from segment class 
5, but make it a member of class 6, you can issue the 
following command: 

< set-segment-class: 1, (5), (6)> 

= <ESC)(S)(A)<int:1> 

<int-array: (5)><int-array: (6)> 

= (ESC)(S)(A)(1)(1)(5)(1)(6) 

Here, the removal array has one class number, namely 
5. The addition array also has one class number, 
namely 6. Thus segment one is removed from class 5 
and added to class 6. It now belongs to exactly classes 
1,6, and 7. 

Using Special Segment Numbers 

In the <set-segment-class> command, you can use 
the special segment numbers — 1 , —2, and —3. For 
instance, you can include all segments in segment 
class 9 as in the following command: 

< set-segment-class: — 1, (empty array), (9)> 

= (ESC)(S)(A)<int:-1> 

< int-array: empty> 
<int-array: (9)> 

= (ESCMS)(A)(!)(0)(1)(9) 

Here, the first parameter specifies segment — 1 , mean- 
ing "all segments." The removal array is empty, so the 
command does not remove "all segments" from any 
class. The addition array holds a single class number, 
9; thus all segments are added to class 9. 



Again, by specifying segment —2, you can cause any 
segments which may be defined later to be members of 
certain segment classes. (On power-up, "segment —2" 
— the default for new segments — does not belong to 
any segment class.) 

For example: 

< set-segment-class: —2, (—1), (1,2,3)> 
< begin-segment: 1 > 
< enter-vector-mode> 

<xy> 

<xy> 



< enter-vector-mode> 
<xy> 
<xy> 



< end-segment> 

< begin-segment: 2> 



< end-segment> 

< set-segment-class: 

< begin-segment: 3> 



-2,(1,2), (4,5,6)> 



<end-segment> 

Here, the first < set-segment-class > command re- 
moves "segment —2" from all segment classes, and 
then adds it to classes 1 , 2, and 3. Since "segment —2" 
means "the default for new segments," when segments 
1 and 2 are created, they are automatically included in 
segment classes 1 , 2 and 3. 

The next < set-segment-class> command removes 
"segment -2" from classes 1 and 2 and then adds it to 
classes 4, 5, and 6. Thus, when segment 3 is defined, it 
automatically becomes a member of segment classes 
3, 4, 5, and 6. 
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By specifying segment —3 in the < set-segment- 
c!ass> command, you can cause a!! segments in the 
current matching class to be added to or deleted from 
specified numbered segment classes. For example, 
consider the following command: 

< set-segment-class: —3, (4,5,6), (1 ,2,3)> 

= (ESC)(S)(A)<int:-3> 

<int-array: (4,5,6) xint-array: (1,2,3)> 

= (ESCKSKA) (#) (3)(4)(5)(6) (3)(1)(2)(3) 

riSie, nit; s&guiGiii nuiiiDci ia — o, meaning an seg- 
ments in the current matching class." The removal 
array holds the class numbers 4, 5, and 6, while the 
addition array holds class numbers 1 , 2, and 3. This 
command causes all segments in the current matching 
class to be removed from classes 4, 5, and 6 and 
added to classes 1 , 2, and 3. 

< SET-CURRENT-MATCHING-CLASS> 
COMMAND 

The current segment matching class is defined by the 
most recent <set-current-matching-class> command. 
That command has the following syntax: 

< set-current-matching-class> 

= (ESCMSML) 
< int-array|> 
<int-array> 

The first < int-array> parameter is the "inclusion 
array." The second < int-array> parameter is the 
"exclusion array." 

The < set-current-matching-class> command sets the 
current segment matching class so as to be the class 
of all segments which belong to all classes in the 
inclusion array, but which do not belong to any classes 
in the exclusion array. 



This can be expressed mathematically as follows. Let 

segment classes A,, A 2 A m be the classes whose 

class numbers are listed in the inclusion array. Let 

segment classes B v B 2 B n be the segment classes 

whose numbers are listed in the exclusion array. Let 
segment class C be the current segment matching 
class. Then segment class C is the intersection of 
classes A, to A m with the complements of classes B, to 
B .: 



C= A, n A 2 n 



. . n A m n B, n b 2 n . . . n B n 

For instanr.p r.nnsirlpr the fallnu/inn ^nmmanrl- 

- _- ».._,., __.. ^._c .,.„ , w „vKii. 8 ww anu. 

<set-current-matching-class: (1,2,5), (3,7,9)> 

= (ESCMSKL) 

<lnt-array: (1,2,5)><int-array: (3,7,9)> 

= (ESCMSKL) (3)(1)(2)(5) (3)(3)(7)(9) 

This command defines the current matching class as 
follows: the class of all segments which belong to 
classes 1 , 2, and 5, and which do not belong to any of 
the segment classes 3, 7, and 9. That is, the current 
matching class is the intersection of classes 1 , 2, and 5 
with the complements of classes 3, 7, and 9. 

ADDITIONAL INFORMATION 

For more information on segment classes, see the 
descriptions in the 41 1 Series Command Reference 
Manual of the <set-segment-class> and <set-cur- 
rent-matching-class> commands. 
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DISPLAYING GRAPHTEXT 



This section describes how to display graphtext and 
how to define your own characters in graphtext fonts. 

There are two ways of displaying text together with 
graphics on the terminal's screen: 

• For compatibiiity with eariier TEKTRONiX terminals, 
the 41 14 is capable of displaying alphatext together 
with graphics. However, to do this, the diaiog area 
must be disabled {< dialog-area-enable: 0> com- 
mand). (If the dialog area is enabled, all alphatext is 
directed to the dialog area.) 

• A better way to display text together with graphics is 
by means of the < graphic-text> command. Text 
included in a < graphic-text> command is called 
graphtext. Graphtext is never displayed in the dialog 
area, regardless of whether the dialog area is 
enabled. 



<GRAPHIC-TEXT> COMMAND 

The < graphic-text> command has this syntax: 

< graphic-text> 

= (ESC) (L)(T)< string: text-to-be-displayed> 

The text to be displayed is sent to the terminal as a 

< string> parameter. Since < str!ng> s are < char- 
array>s, the only characters which may be displayed 
are those which are valid <char> parameters: the 
ASCII characters from (SP) to (~) — decimal equiva- 
lents from 32 to 1 26. Characters outside this range are 
ignored if they occur within a <string> parameter. 

The first character of the text string is displayed with 
its lower left corner at the current graphic beam 
position. Figure 7-1 shows the effect. 
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The < graphic-text> command displays its graphtext 
with the lower left corner of the text string at the 
current graphic beam position. As each character of 
the string is displayed, the graphic beam position is 
moved to the lower left corner of the next character 
cell. At the end of the < graphic-text> command, the 
graphic beam position is just beyond the end of the 
graphtext string. 



If displaying a character moves the graphic beam out of 
terminal space, that character (and the rest of the 
string) is not displayed, and the graphic beam position 
does not change. 



< enter— vector— mode> 

<xy> 

<xy> 



<move: (350,291 2) > 

< graphic-text: "A"> 
<move: (469,288) > 

< graphic-text: "B"> 



<move: (973,1 231 )> 

< graphic -text: "H (Orthocenter)"> 



Draw picture. 




/ Label the points with 
<graphic— text> commands 
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Figure 7 - 1 . Effect of < Graphic -Text > Command. 
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<SET-GRAPHTEXT-SIZE> COMMAND 

The < set-graphtext-size> command lets you set the 
width, height, and spacing of graphtext characters. The 
command has the following syntax: 

<set-graphtext-size> = (ESC)(M)(C) 

< int: character-width> 

< int: character-height> 

< int: inter-character-spacing> 



The three < int> parameters are in terminal space 
units. The width and height must be in the range from 1 
to 4095, while the spacing may range from to 4095. 

Figure 7-2 shows the effect of this command. In this 
figure, a < set-graphtext-size: 50,1 00,25> command 
was sent just before the < graphic-text: "H (Orthocen- 
ter)"> command. 



<set— graphtext— size: 50,100,25> 

t t 
character width ■ 

character height 

inter-character spacing — 



1 



CHARACTER WIDTH 



CHARACTER 
HEIGHT 



INTER-CHARACTER 
SPACING 




—\ r* 

(Orthoce 



Figure 7-2. Effect of < Set-Graphtext-Size> Command. 
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< SET-GRAPHTEXT-ROTATION> 
COMMAND 

The <set-graphtext-rotation> command lets you 
specify the counterclockwise rotation angle (in de- 
grees) for all subsequent graphtext strings. (A negative 
rotation angle causes clockwise rotation.) The com- 
mand has the following syntax: 

< set-graphtext-rotation> 

= (ESO(MMR) <real: angle-in-degrees> 

Figure 7-3 shows the effect. In the figure, a <set- 
graphtext-rotation: 30.0> comand was sent just before 
the < graphic-text: "H (Orthocenter)"> command. 



<SET-GRAPHTEXT-PRECISION> 
COMMAND 

The <set-graphtext-precision> command sets the 
precision level for subsequent graphtext. The command 
has the following syntax: 

<set-graphtext-precision> = (ESC)(M)(Q)<int> 

The < int> parameter is 2 for stroke precision and 1 
for string precision. Figure 7-4 shows the command's 
effect. String precision graphtext (and alphatext) can- 
not be rotated, nor can its size be changed with the 
< set-graphtext-size> command. (Instead, use the 
<set-alphatext-size> command.) 

The < set-graphtext-font> command, described later 
in this section, does not affect string precision graph- 
text. 




Figure 7-3. Effect of <S«t-Qraphtaxt-Rotation> Command. 
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A. STROKE-PRECISION GRAPHTEXT. 




B. STRING-PRECISION GRAPHTEXT. 
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Figure 7-4. Effect of <8«t-Graphtaxt-Preclaloii> Command. 
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PREDEFINED GRAPHTEXT FONTS 

You can select alternate graphtext fonts with the <set- 
graphtext-font> command. When the terminal is turned 
on, there is always at least one predefined font: Font 0, 
the standard ASCII font. You can also create your own 
graphtext fonts. Such fonts are called user-defined 
fonts; how to create them is described later in this 
section. 



Fonts Provided with Keyboard Options 

If the terminal has an optional keyboard (Option 4A, 4C, 
4E, or 4F) then Font is not the only predefined 
graphtext font. Such a terminal also has predefined 
Fonts 1 , 3, 7, and 9. Table 7-1 lists these fonts. 
However, when the terminal is turned on, the default 
graphtext font is always the ASCII font, Font 0. This is 
true even for terminals equipped with optional key- 
boards. If you want to select another predefined font, 
you must do so explicitly with a <set-graphtext-font> 
command. The optional keyboard fonts are shown in 
Figure 7-5. 



FONTO 

(ASCII) 



FONT1 

(Swedish) 



FONT 3 

(United Kingdom) 



FONT 7 

(APL) 



FONT 9 

(Danish/Norwegian) 



! "#$%&'< )*+,-. /01 23456789: ; <=>? 
@ABCDEFGH I JKLMNOPQRSTUVWX YZ C \ ] ~_ 
"abcdef ghi jklmnopqrstuvwxgz< I >~ 

! "#$%&'( >*+,-. /01 23456789: ; <=>? 
@ABCDEFGHIJKLMNOPQRSTUVWXYZA0fV_ 
'abcdef ghi jklmnopqrstuvwxgzdba~ 



! "£$%& ' ( )*+,-. /01 23456789: ; <=>? 
0ABCDEFGH I JKLMNOPQRSTUVWXYZ C \ ] "_ 
'abcdef ghi jklmnopqrstuvwxgz< i >~ 

_"" )<<=>] va**, +. /01 23456789( C ; x : \ 
a±nLe_VAi* ' D I to*?p r-iuco3tc-r-*>- 
<>ABCDEFGhIJKLHNOPQRSrVVUXYZ<-0$ 

! "#$%&'( )*+,-. /0123456789: ; <=>? 
@ABCDEFGHIJKLMNOPQRSTUVWXYZ(t:0A' n _ 
s abcdef gh i j k 1 mnopqrstu vwxgzcead" 
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Figure 7-5. Fonts Provided with Keyboard Options. 
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Table 7-1 

GRAPHTEXT FONTS SUPPLIED WITH 
OPTIONAL KEYBOARDS 



Font Number 


Graphtext Font 





Standard ASCII font 


1 


Swedish font 


3 


United Kingdom font 


1 


rtrL iwru 



<SET-GRAPHTEXT-FONT> COMMAND 

The < set-graphtext-font> command lets you select 
any of these fonts for displaying subsequent graphtext. 
The command has the following syntax: 

< set-graphtext-font> 

= (ESC)(M)(F)<int: font-number> 

Figure 7-6 shows the effect of the < set-graphtext- 
font> command. !n this figure, Font 2 is assumed to be 
a user-defined font. (Defining such a font is described 
later in this section.) 



Danish/Norwegian font 




Figure 7-6, Effect of <Set-Gr«phtext-Font> Commend. 
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DEFINING YOUR OWN GRAPHTEXT CHARACTERS 



GENERAL PROCEDURE 

The following steps show examples of commands for 
defining your own graphtext characters. These com- 
mands are described in more detail later in this section. 

1 . < Delete-graphtext-character: 2, — 1 > 
< Set-graphtext-font-grid: 2, 60, 80> 

Delete all user-defined characters in graphtext 
Font 2, and then specify a "font grid" for defining 
your own Font 2 graphtext characters. 

2. < Set-pivot-point : (0,0)> 

The pivot point for subsequent graphtext charac- 
ters will be (0,0). When the character is displayed 
(by a < graphic-text> command), its pivot point 
appears at the current graphic beam position. 

3. < Begin-graphtext-character: 2, 65> 

< enter-vector-mode> 
<xy> 
<xy> 



< enter-vector-mode> 
<xy> 
<xy> 



< end-graphtext-character> 

Define character number 65 (uppercase A) in 
graphtext Font 2. The character definition starts 
with the <begin-graphtext-character> command 
and ends with the < end-graphtext-character> 
command. The character is defined as a series of 
vectors, or line segments. The vectors may be 
drawn with < enter-vector-mode> commands — 
(GS) characters — and <xy> parameters. Alterna- 
tively, they may be drawn with < move> and 
<draw> commands. 

Repeat Steps 2 and 3 for each subsequent 
character definition. You can omit Step 2 (the 

< set-pivot-point> command) if the the character 
being defined is to have the same pivot point as the 
previous character defined. 



< DELETE-GRAPHTEXT-CHARACTER > 
COMMAND 

The < delete-graphtext-character> command has this 
syntax: 

< delete-graphtext-character> 

= (ESCMSMZ) 

< int: font-number> 

< int: character-number> 

Font Number. The font number must be —1 , or in the 
range from to 32767. "Font — 1 " means "all user- 
defined fonts." 

Character Number. The character number must be 
— 1 , or in the range from 32 to 1 26. 

Specifying character number —1 deletes all user- 
defined characters in the specified font and also 
deletes the font grid for that font. If the font is not one 
of the predefined fonts (Font in a standard terminal; 
Font 0, 1 , 3, 7, or 9 in a terminal with a keyboard 
option), then specifying character number -1 also 
makes that font inaccessible. (The < set-graphtext- 
font> command results in an error if an attempt is 
made to select a font which is not predefined and does 
not have a font grid for user-defined characters.) 

Specifying a character number from 32 to 1 26 deletes 
that particular user-defined graphtext character. The 
user-defined character is superceded by the corre- 
sponding pre-defined character. In most cases, this is 
the corresponding standard ASCII (Font 0) character. 
For Fonts 1 , 3, 7, and 9, if an optional keyboard is 
installed, this is the corresponding character from the 
same predefined font. 
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< SET-GRAPHTEXT-FONT-GRID> 
COMMAND 

The < set-graphtext-font-grid> command has the fol- 
lowing syntax: 

< set-graphtext-font-grid> 
= (ESCMSHG) 

< int : font-number> 

< int : width-of-grid> 

< int : height-of-grid> 

This command sets the width and height of a graphiexi 
font grid used in defining graphtext characters. For 



each user-defined character in the specified font, the 
graphtext font grid is a rectangle extending above and 
to the right of that character's pivot point. 

Suppose, for instance, that the width of the grid is 30, 
and the height is 40. If the uppercase A character 
(character number 65) is defined with its pivot point at 
(0,0), then its font grid extends from X= to X= 30, and 
from Y= to Y= 40. Likewise, if the lowercase g 
character is defined with its pivot point at (0,1 5), then 
its font grid extends from X= to X= 30, and from 
Y= 1 5 to Y= 55. Figure 7-7 illustrates this. 
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Figure 7 -7. Font Grids For Two Utar-Daflnod Characters. 
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Later, when the character is displayed, the width and 
height of the font grid are mapped onto the current 
graphtext-size width and height, while the pivot point is 
mapped onto the current graphic beam position. Figure 
7-8 illustrates this. 

All user-defined characters in a graphtext font share 
the same font grid. Therefore, issuing a < set-graph- 
text-font-grid> command is not allowed if there 
already exists a font grid for the specified font. (The 
terminal detects a type SG03 error; see the 41 1 
Series Command Reference Manual for details.) 

Before sending a <set-graphtext-font-grid> command, 
therefore, you should delete any font grid which may 
already exist for that font. To do this, issue a < delete- 
graphtext-character> command with "minus one" as 
the character number; that not only deletes all the 
user-defined characters in the font, but also deletes 
the font grid. 

In order to select a graphtext font which is not one of 
the predefined fonts, It is necessary that a font grid has 
been established for that font. For example, if no <set- 
graphtext-font-grid> command has been issued for 
Font 2, then the < set-graphtext-font: 2> command 
results in an error. 



<SET-PIVOT-POINT> COMMAND 

The < set-pivot-point> command has this syntax: 

< set-pivot-point> = (ESC)(S)(P)<xy> 

This command sets the pivot point for subsequent 
graphtext character definitions, as well as for subse- 
quent segment definitions. (See Section 6 for a de- 
scription of segment definitions.) 

< BEGIN-GRAPHTEXT-CHARACTER> 
COMMAND 

The < begin-graphtext-character> command has this 
syntax: 

< begin-graphtext-character> 
= (ESCHSMT) 

< int: font-number> 

< int: character-number> 

This command starts the definition of a particular user- 
defined graphtext character. The font number must be 
in the range from to 32767; the character number 
must be in the range from 32 to 1 26. 

< END-GRAPHTEXT-CHARACTER> 
COMMAND 

Each graphtext character definition ends with the 

< end-graphtext-character> command: 

< end-graphtext-character> = (ESC)(S)(U) 

For more information on these commands, see the 
41 10 Series Command Reference Manual. 
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Figure 7-8. Displaying User-Defined Qraphtext Characters. 
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GRAPHIC INPUT 



INTRODUCTION 



This section shows examples of GIN (graphic input) 
operations. Like all sections of this manual, it should be 
read with the 4110 Series Command Reference Manual 
close at hand. You will need the Command Reference 
Manual for detailed descriptions of the individual GIN 
commands. 

In this section under the heading "Enabling for Graphic 
Input" is a description of the < enable-GIN> command 
and of GIN functions and GIN devices. Here also is a 
brief list of other GIN commands. 

The next three major headings ("Locator Function," 
"Pick Function," and "Stroke Function") give examples 
of how to perform graphic input. These examples also 
show how to use other GIN features: 

• Locator function. The example of the locator func- 
tion also shows how to use the "gridding" and 
"rubberbanding" features. 



• Pick function. The example of the pick function also 
shows how to insert<pick-ID>s in the display list 

iui a ooyinoui. 

• Stroke function. The example of the stroke function 
shows how to use "stroke filtering" and "inking" 
features. 

By the time you have studied these examples, you 
shouid know how to do graphic input with the 41 14 
terminal. The remaining major head describes a more 
advanced topic: "Using Severai GiN Devices at Once." 



ENABLING FOR GRAPHIC INPUT 



<ENABLE-QIN> COMMAND 

The <enable-GIN> command enables the terminal for 
graphic input. The command has this syntax: 

<enable-GIN> = (ESC)(l)(E)<intxint+ > 



Device- Function Code 

The first parameter Is an < int> holding a device- 
function code. This code specifies the GIN device 
which is enabled, and the GIN function for which that 
device Is enabled. 

Table 8-1 lists the valid device-function codes. 





Table 8-1 


Device-Function ID Cod* Numbers 


Code 


Device-Function Code 





Thumbwheels-Locator 


1 


Thumbwheels-Pick 


8 


Tablet-Locator 


9 


Tablet-Pick 


10 


Tablet-Stroke 


24 


Plotter at Port - Locator 


25 


Plotter at Port - Pick 


32 


Plotter at Port 1 - Locator 


33 


Plotter at Port 1 - Pick 


40 


Plotter at Port 2 - Locator 


41 


Plotter at Port 2 -Pick 
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Number of GIN Events 

The <enable-GIN> command's second parameter 
specifies for how many GIN events the device is being 
enabled. You can enable a device "permanently" (that 
is, until the terminal is turned off or a < disable-GIN> 
command is received) by specifying a large number, 
such as 65535, as the number of GIN events. 

Each GIN event occurs when the terminal receives a 
single point's location from the operator and sends to 
the host a report including that position. If the graphic 
input device is the thumbwheels, the operator enters a 
point (signals a GIN event) by typing a character on the 
keyboard. For the optional graphics tablet, the operator 
signals a GIN event with the tablet pen or optional 
cursor. With the optional plotter, the operator signals a 
GIN event with a switch on the plotter. In any case, a 
GIN event occurs when a point's position is entered for 
graphic input. 

The terminal remains enabled for graphic input from 
the specified device until one of the following occurs: 

• The <enable-GIN> command's second parameter 
is satisfied. That is, the specified number of GIN 
events have occurred. 

• A <disable-GIN> command is received. 

• A < cancei> command is received, or the operator 
presses the CANCEL key. 



Examples 

<enabie-GIN:0, 1> 

<enable-GIN: 1,3> 
<enable-GIN:8,30> 



Enables the thumbweels 
device and locator function 
for one GIN event. 

Enables the thumbwheels 
for three pick events. 

Enables the tablet for 30 
locator events. 



< enable-GIN: 1 0, 65535 > Enables the tablet for a 

large number of stroke 
events. 



GIN DEVICES 

There are three types of GIN devices: thumbwheels, 
tablet, and plotter. 

Thumbwheels 

The operator uses the thumbwheels to position the 
graphic cursor and then signals a GIN event by 
pressing any ASCII key on the keyboard. 

Tablet 

The operator positions the graphic cursor by moving a 
stylus or tablet cursor over the surface of the optional 
graphic tablet. The operator signals a GIN event by 
pressing the stylus against the tablet, or by pressing a 
button on the tablet cursor. (In the case of the stroke 
function, GIN events occur automatically throughout 
the stroke. This is described later in this section.) 

Plotter 

If the 41 1 4 is equipped with Option 1 (Three Port 
Peripheral Interface), then a TEKTRONIX 4662 or 4663 
Interactive Digital Plotter may be attached to one of the 
three peripheral ports. Such a plotter may be specified 
as a graphic input device. If a plotter is the GIN device, 
then the operator positions the graphic cursor by 
moving the plotter pen with the plotter joystick. The 
operator signals a GIN event by pressing a switch on 
the plotter. 



GIN FUNCTIONS 

There are three GIN functions: locator, pick, and stroke. 

Locator Function 

When the locator function is enabled, a graphic cursor 
appears on the screen. (The default graphic cursor Is a 
large pair of crosshairs; however, any segment can be 
used as the graphic cursor.) 

The operator positions the cursor at some point on the 
screen, and then signals a "GIN event." Just how the 
operator does this depends on which GIN device has 
been enabled. For instance, If the thumbwheels are the 
GIN device, then the operator moves the cursor by 
manipulating the thumbwheels and signals a GIN event 
by pressing a keyboard key. 
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When the operator signals the GIN event, the terminal 
responds by sending a < GIN-locator-report> to the 
host computer. (An optional signature character is sent 
at the start of this report; this Is described later in this 
section.) The <GIN-locator-report> tells the host (a) 
which key the operator pressed, and (b) the location of 
the graphic cursor in 4096-by-4096 terminal space. 

Pick Function 

When the pick function is enabled, a graphic cursor 
s^psars. jha operator "nicks" a segment (or part of a 
segment), and the terminal sends a < GIN-pick-re- 
port> to the host computer. 

To pick a segment, the operator moves the graphic 
cursor to the desired segment (or part of a segment) 
and signals a GIN event. The operator does this just as 
for the locator function. For instance, he or she may 
move the thumbwheels to position the graphic cursor 
and press a key to signal the GIN event. 

In response to the GIN event, the terminal sends a 
< G!N-pick-report> to the host computer. This report 
tells which key the operator pressed, where the cursor 
was when the operator pressed that key, which seg- 
ment was picked, and what part of that segment was 
picked. The < GIN-pick-report> , like the < GIN- 
locator-report> , may be preceded by an optional 
signature character. 

Stroke Function 

The stroke function is valid only for the tablet. 

When the stroke function is enabled, the graphic 
cursor appears at a point on the screen which 
corresponds to the position on the tablet of the tablet 
pen or tablet cursor. If you want to rely only on the 
tablet pen or cursor and would rather not see a graphic 
cursor on the screen, then use an empty segment as 
the graphic cursor. 

Each "stroke" is deemed to be many separate GIN 
events, each of which causes a <GIN-stroke-report> 
to be sent to the host computer. The operator begins a 
stroke by pressing the tablet pen against the tablet, or 
by pressing a button on the tablet cursor. The operator 
then moves the pen (or cursor) across the tablet 
surface and ends the stroke by releasing pressure on 
the pen (or cursor button). 



During the stroke, the terminal sends many <GIN- 
stroke-report> s to the host computer. The format of 
these reports, and details of when they are sent, are 
described iater in this section. 

<DISABLE-GJN> COMMAND 

The <enable-GSN> command specifies a number of 
GIN events for which the GIN device and function are 
enabled. You can, however, disable graphic input from 
that device-function combination before all those GIN 
events have occurred. To do so, use the < disable- 
GIN> command: 

<disable-GIN> = (ESC)(l)(D)<int> 

Here, the < int> parameter is the device-function code 
for the GIN device and function which are to be 
disabled. 

OTHER GIN COMMANDS 

There are a variety of other GIN commands, which set 
other parameters associated with graphic input opera- 
tions. These let you select alternate graphic cursors, 
choose the signature characters used in GIN reports, 
constrain the cursor to lie only on the intersection 
points of an imaginary grid, enable or disable "rubber- 
banding" and "inking," and so on. These commands 
are demonstrated in the examples which follow. 

These commands pertain to GIN operations: 

• <enable-GIN> 

• <d!sab!e-G!N> 

• <set-GIN-cursor> 

• < set-GIN-grlddlng> 

• <set-GIN-rubberbanding> 

• <set-GIN-stroke-filterlng> 

• < set-pick-ID> 

• < set-report-sig-chars> 

• < 8et-report-EOM-f requency> 

• <set-report-max-line-length> 

You can find detailed information on these commands 
in the 41 10 Series Command Reference Manual. 
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LOCATOR FUNCTION 



The following example of the locator function also 
shows how to use the terminal's "gridding" and 
"rubberbanding" features. 

PREPARING FOR GRAPHIC INPUT 

To prepare the terminal for graphic input from the 
thumbwheels, using the locator function, you might 
issue the following commands: 

< set-report-EOL-string: (13)> 

< set-report-sig-chars: 0, 87, 1 19> 

< set-report -EOM-frequency. 1> 

< set-GIN-gridding: 0, 1 00, 1 00> 

< set-GIN-rubberbanding: 0, 1 > 
<enable-GIN:0, 5> 

The < set-report-EOL-string> command sets the ter- 
minal's end-of-line string to be the single (CR) 
character, which has a decimal equivalent of 13: 

< set-report-EOL-string: (13)> 
= (ESC)(N)(T)<int-array:(13)> 
= (ESC)(N)(T)<int: 1><int: 13> 
= (ESC)(N)(T)(1)(=) 

The < set-report-sig-chars> sets the "signature char- 
acters" used in the <GIN-report-sequence> which the 
terminal sends to the host. The command sets signa- 
ture characters for device-function code zero: 
thumbwheels device, locator function. The <sig-char> 
sent before each <GIN-locator-report> is (W), which 
has a decimal equivalent of 87. The < term-sig-char> , 
which marks the end of the < GIN-report-sequence> , 
is (w), which has a decimal equivalent of 1 1 9. 

< set-report-sig-chars: 0, 87, 1 1 9> 

= (ESC)(I)(S)< int: 0> < int: 87> < int: 1 1 9> 
= (ESC)(I)(S)(0)(E)(7)(Q)(7) 

The < set-report-EOM-f requency> command causes 
the terminal to send an < EOM-indicator> after each 
<GIN-locator-report> in the < GIN-report-se- 
quence> . If the terminal is not in block mode, this 

< EOM-indicator> is just the current < EOL-string> , 
which has been set to (CR). 

< set-report-EOM-frequency: 1 > 

= (ESC)(l)(M)<int:1> 
= (ESCHIMMHD 



The <set-GIN-gridding> command enables gridding 
for device-function code zero. The graphic cursor is 
constrained to points in terminal space which have x- 
and y-coordinates that are both multiples of 100. 

< set-GIN-gridding: 0, 1 00, 1 00> 

= (ESC)(l)(G)<int: Ox int: 100><int: 100> 
= (ESC)(I)(G)(0)(F)(4)(F)(4) 

The <set-GIN-rubberbanding> command enables the 
"rubberbanding" feature for device-function code zero. 
After the first point is entered, the terminal displays a 
"rubberband line" between the orevious point and the 
current cursor position. 

< set-GIN-rubberbanding: 0, 1 > 
= (ESC)(l)(R)<int: OX int: 1> 
= (ESC)(I)(R)(0)(1) 

After all these GIN parameters have been set, the 
<enable-GIN> command enables device-function 
code zero (thumbwheels device, locator function) for 
five GIN events. 

<enable-GIN:0, 5> 

= (ESCMl)(E)<int:0xint:5> 

= (ESC)(I)(E)(0)(5) 

OPERATOR AND HOST INTERACTION 

The following steps show one way the preceding 
commands might be used in a host application 
program: 

1 . The program begins by issuing a < begin-seg- 
ment> command and instructing the operator to 
"type M to move, D to draw, or X to exit this 
program." 

2. The program then sets various graphic input 
parameters, and enables the device-locator func- 
tion for a large number of GIN events. To do this, 
the program sends the following commands to the 
terminal: 

< set-report-sig-chars: 0, 87, 1 1 9> 

< set-report-EOM-frequency: 1 > 
<set-GIN-grlddlng: 0, 1 > 

< set-GIN-rubberbanding: 0, 1> 
<enable-GIN:0,32767> 

3. As the terminal executes the < enable-GIN> 
command, it displays the crosshair cursor. 
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4. 



The operator moves the thumbwheels, using them 
to position the cursor at a desired point on the 
screen. 

Because gridding is enabled, the cursor only 
moves to points on an invisible grid. That is, it only 
moves to points which have x- and y-coordinates 
that are both multiples of 1 00. 

After the first point has been entered, the terminal 
displays a 'rubberband line' from the last point 
entered to the current cursor location. 



5. The operator enters each point by pressing a 
keyboard key. (The operator has been instructed to 
press M for a "move," D for a "draw," and X to exit 
the program.) 

6. When the operator presses a key, the terminal 
blinks the crosshair cursor and sends a < GIN- 
locator-report> to the host computer. Each < GIN- 
locator-report> is preceded by (W) — the 
signature character — and followed by (CR) — the 
end-of-line string. Figure 8-1 shows a typical 

< GIN-report-sequence> for the locator GIN 
function. 



Atypical * CH»-**p3r«-»aqu«iwe- i 



- ((W)(m) (=) (SP) (=) (") (+) (CR)) ' 

(W)(d) (=) (SP) (=) (.) (") (CR) 

(W)(d) ($) (SP) (3) (2) (8) (CR) 

(W)(d) (,) (SP) (0) (") (:) (CR) >-«- 

(W)(m) (') (SP) (!) (&) (0) (CR) 

(W)(d) (') (SP) (!) (6) (5) (CR) 

(W)(x) ( =) (SP) (=) (*) (>) (CR) J 

((w)(CR)> 



■<GIN— report— item>s 



■ < final — GIN— report— item> 



*. i t ■■'■■*' ■■ i»!K--a:sv-r<." i*-i 
(W) (m)(=)(SP)(= )(")(+) (CR) 

t ' 1 



. Sly — wiidi ^ 

<GIN— locator— report> 

<eom— indicator> 

A typteftf <SlK~l«calw~MW«wt> : 



(m)(=)(SP)(= )(")(+) 



key which the 
operator pressed 



J 



<xy-report> for 
the cursor position 



Atypical ■ fn«:0'N-»pon-i*rr.> 



< term-sig-char>- 
<eom-indicator>- 



(w) (CR) 

J t 



tf *"-■»>- ess 



38W-a>| 



Figure 8-1 . Typical < QIN-Raport-Saqu«nca> for tha Locator Function. 
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7. The host applications program parses (reads) the 
< GIN-report-item> and takes appropriate action. 

To parse the < GIN-report-item> , the program 
reads characters coming from the terminal until it 
finds the signature character (W). It then calls a 
subroutine to parse the following six characters, 
which comprise a < GIN-locator-report> . 

To parse the < GIN-locator-report> , the host reads 
the first character, which tells which key the 
operator pressed. It then calls another subprogram 
to parse the next five characters, which comprise 
an < xy-report> . 

When done parsing the < GiN-ioeaior-repori> , the 
host knows (a) which key the operator pressed, 
and (b) where the cursor was when the operator 
pressed that key. Based on this information, the 
host then takes appropriate action. 

If a "move" was requested (operator typed M or m), 
the host issues a < move> command for the point 
just reported as the cursor position. (Alternatively, 
it could issue an < enter-vector-mode> command 
and an < xy> parameter.) 

If a "draw" was requested (operator typed D or d), 
the host issues a <draw> command for the point 
just reported as the cursor position. 

If an "exit" was requested (operator typed X or x), 
the host issues a <disable-GIN: 0> command. 
This disables graphic input for the thumbwheels 
device and locator function. 

If the operator typed some other character, then 
the host sends instructions to the operator. 



8. Steps 4 through 7 are repeated again and again, 
until the operator signals an "exit" from the 
program. (That is, until the operator types X or x.) 

9. When the operator types X or x, the terminal stops 
displaying the graphic cursor and sends the host a 
< f inal-GIN-report-ltem> . This < final-GIN-report- 
item> consists of the < term-sig-char> (the 
lowercase w character) and an < EOM-indicator> 
(the carriage return character, which is the current 
end-of-line string). 

10. The host parses the <final-GIN-report-item> and 
uses it as a signal to exit its program loop. 

i i . The host sends an < end-segment> command to 
the terminal. All the < move> s and < draw> s 
which it sent during the graphic input operation are 
now included in a segment. 

1 2. This is the end of this graphic input example. The 
example program exits, returning control to the 
host operating system. 

Figure 8-2 shows a PASCAL program fragment for this 
graphic input example. (The complete PASCAL pro- 
gram is reproduced in Appendix C.) 
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• 
• 

PRncFD'lRE ParseGinPeportTtemAndTakeApprorrlateActlonj (MKHKHHHH 




O 4FGTN < 




^i <•* Look for signature character »»> { 




O WHILF not (tty* IN_['w', •■*• ]){• while next Char is not w *> < 




O DO BEGIM <»» skip past the non-w character •*} i 




O IF Eoln(TTY) <## if next character Is a (CR) »»> < 




O THEN < 




O ReadlnCTTY) <*• advance to 1st char of next line »»» < 




O EI.SF < 










<} END: < 




<> Head(TTY,SionatureChar)» { 




<> rF CsignatureChar = 'w') { 




O them {*# Parse a <GlN-ioeator-report>. «») < 




(> BEGIN < 




O Read(TTY,KevChar)s < 




O ParseAnxyRebortrxv) j . < 




»> IF KevChar IN C*M*# *ln*f # D* f *d*i 'X*, 'x'J < 




O thfn {## taice the appropriate action »»> < 




O CiSF KevChar of { 




<> <> 'M' f '<*» : Move(Xy). { 




{> O '0*, 'd* : Oraw(Xy)> ( 




<> <> 'X', 'x* s DisablenintO); ( 




O <> ENn <*• of CASE statement »#> < 




<> ELSE (»« Tf he typed an invalid key char ••> < 




O DisplayTnstructions* < 




O EXDj . < 




O END: <» of ParseGinPeoortltemAndTakeAppropriateActlon procedure »> { 




(HHHI(H)IHI(HHIIHHHHHHKHHHKH)(H)(HI(KHI(H1(IIM 




SEGTN <•• Main prooram *»} 




(»# Prepare dialog area »») 




EnabieDialooAreaCt )! 




SetDialogAreavisibilltydl » 




<*» Prepare for GI« »»> 




<»» <set-EOL-string : fl3)> »«> 




InltializeNewIntArrav(TntArray); 




lonfnaToTn^^rrjyf T«Hrf»tf. 1 ^ > ■ 




SetEoiStringf intArrav) » 




setReportSi>JChars(0,87,U9)i <« (W), f<n • > 




<5etPeoortFomFre<iueneyirn; <« "wore frequent " «> 




SetReportMaxLlneLemth(72): 




SetGinGrlddino(0,100 f 100) « <• enable griddlng ••} 




setGinRubberbandingf 0. n j <» enable rubberbanding •> 




{*« Tell operator what to do *•) 




'iandshake» <* Be sure previous commands have been executed «> 




n isp lay Instructions! 




<»• ripen a segment ••> 




oeleteSegmentf-t )t <»» nelete all old segments. »•> 




«eginSegment(1 ) j 




<»• Enable for GIN *»> 




PnableGinjfO, 32767); <*# "32767" means. "many points" #•> 




(•• Loop until a <term-sf g-char> is received. »») 




REPEAT 




Parsed nReoort I temAndTake Appropriate Act ion 




'iMTIt, signatureChar a »»'r 




<*• Close the segment. ••} 




indSegment ; 




EMD. 






3675-30 



Rgura 8-2. Graphic Input Example: Thumbwhoala- Locator Davlea-Functlon Coda. 
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PICK FUNCTION 



INTRODUCTION 

The graphic input "pick" function lets the operator 
choose one segment from among several which may be 
defined. For instance, in a drafting application, the 
operator might pick one of several circuit symbols. 

A typical pick operation proceeds as follows: 

1 . The host computer enables a graphic input device 
for the pick function. 

2. Using the enabled device (thumbwheels, tablet, or 
plotter), the operator moves the graphic cursor 
until it is at the image of the segment which is to be 
picked. The operator then presses a keyboard key 
(or plotter switch, or tablet pen, etc.) to signal the 
"pick event." 

3. The terminal responds to the pick event by sending 
a < GIN-pick-report> to the host computer. This 
report tells the host (a) which key the operator 
pressed, (b) which segment the operator selected, 

(c) which parr of that segment was selected, and 

(d) the graphic cursor location. 



PREPARING SEGMENTS FOR PICKING 

For a segment to be picked, several conditions must be 
met: 

• Obviously, the segment must exist: it must have 
been defined with <begin-segment> and < end- 
segment commands. 

• The segment must be detectable — that is, pickable. 
A segment's detectability is set by the <set- 
segment-detectability> command. 

• Part of the segment must fall within the current pick 
aperture. The pick aperture is a rectangle whose 
center is at the current graphic cursor position. (The 
size of this rectangle is determined by the < set- 
pick-aperture> command.) 

• The part of the segment which falls within the pick 
aperture must have a pick ID number (pick identifi- 
cation number) which is greater than zero. Parts of a 
segment may be given different pick ID numbers 
with <set-pick-ID> commands. These commands 
must be included in the segment definition at the 
time the segment is defined. 

Figure 8-3 shows how to prepare segments for picking. 
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-delete-segment: — 1>-*- 
< begin-segment: 1 > < 



-Delete all existing segments. 

Begin segment one. Each new segment 
' starts with a pick-ID of one. 



< enter-vector-mode > 
<xy> 
<xy> 



< enter- vector- mode > 
<xy> 
<xy> 



< set-pick-ID: 2> 

< enter-vector-mode> 

<xy> 

<xy> 



< enter- vector- mode > 
<xy> 
<xy> 



Commands to define 
part of segment one. 



Define another part of the 
' segment, assigning it to 
pick-ID two. 



< end-segment> -*- 



• End of segment one. 



< begin -segment > 
< entsr-vecior-mode; 
<xy> 
<xy> 



< enter-vector-mode > 



Define segment two. Because there 
are no <set-pick-ID> commands 
in the segment definitions, all of 
segment two has the default 
pick ID of one. 



< end- segment > 



< set-segment-detectability: — 1, 1 > 



-Make all segments detectable. 



3675-31 



Figure 8-3. Preparing Segments for Picking. 
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OPERATOR AND HOST INTERACTION 

The following steps show one way a host applications 
program might use the "pick" graphic input function: 

1 . The program begins by defining several segments 
at different locations on the screen. 

2. Next, the program issues commands to prepare the 
terminal for five GIN pick events, using the tablet 
as the graphic input device ("tablet-pick" is de- 
vice-function code 9): 

< set-EOL-string: (13)> 

< set-report-sig-chars: 9, 84, 1 1 6> 

< set-report-EOM-frequency: 1 > 
<enable-GIN: 9, 5> 

3. As the terminal executes the < enable-GIN> 
command, it displays the crosshair cursor. 

4. The operator moves the tablet pen (or tablet 
cursor); this causes the crosshair cursor to move 
around the screen. When the cursor is at the image 
of the desired segment, the operator presses the 
tablet pen against the tablet (or presses a button 
on the tablet cursor). This signals a GIN pick event. 



5. The terminal responds by sending a < GIN-report- 
item> to the host computer. The <GIN-report- 
item> consists of an uppercase letter T (the 

< sig-char> ), a < GIN-pick-report> , and the car- 
riage return character (the <EOM-indicator>). 

The <GIN-pick-report> tells the host (a) which 
segment the operator picked, (b) the pick ID 
number for the part of the segment which is near 
the graphic cursor, and (c) the location of the 
graphic cursor. 

The terminal also "blinks" the graphic cursor. This 
provides feedback to reassure the operator that 
the pick operation was successful. 

6. The host program reads the < GIN-pick-report> 
and takes whatever action is appropriate. 

7. In Step 2, the < enable-GIN> command specified 
five pick events. Therefore Steps 4, 5, and 6 are 
repeated four more times. 

8. After sending the fifth < GIN-pick-report> , the 
terminal sends the <final-GIN-report-item> . This 
consists of the lowercase t character (the < term- 
sig-char>) and a carriage return character (the 
<EOM-indicator>). 

Figure 8-4 shows a typical sequence of reports which 
the terminal might send the host for this graphic input 
example. 



STROKE FUNCTION 



INTRODUCTION 

The graphic input "stroke" function is valid only when 
the Option 1 3 or Option 1 4 graphics tablet is the 
graphic input device. 

The operator begins each stroke by pressing the pen 
against the tablet, or by placing an optional cursor on 
the tablet surface and pressing a switch on that cursor 
The operator then moves the pen (or cursor) along the 
tablet surface. As he does so, the terminal sends a 
stream of < GIN-stroke-report> s to the host computer. 
Each < GIN-stroke-report> reports one xy-coordinate 
to the host. Each such report counts as a separate GIN 
event for purposes of the <enable-GIN> command's 
"count" parameter. 



A stroke ends when either of the following occurs: 

• The<enable-GIN> command's count parameter is 
satisfied. 

• The operator stops pressing the pen against the 
tablet, stops pressing the button on the tablet 
cursor, lifts the pen or cursor away from the tablet, 
or moves the pen or cursor outside the tablet's 
"presence area." 

The stroke function is enabled by specifying device- 
function code 1 (tablet device, stroke function) in an 
<enable-GIN> command. 
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A typical < GiN-raport-aaqtianca> • 



- JW) (a) 
(W) (B) 
(W) (C) 
(W) (d) 
(W) (e) 
(W) (f) 
(W) (g) 



(8) 
1ST 

(1) 

(1) 

(1) 

(-) 

(-) 



(SP) (&) 

T5PT7T 

(SP) (2) 
(SP) (2) 
(SP) (2) 
(SP) (6) 
(SP) (6) 



(w) (h) mwpw-t 






(4) 

l4T 

(6) 

(0) 

(1) 
(1) 
(,) 
(,) 



(SP) (SP) (SP) (6) 
(<) (SP)(SP)(6) 
(SP) (SP) (SP) (5) 
(,) (SP) (SP) (5) 
(4) (SP)(SP)(4) 
(4) (SP)(SP)(4) 
("(") (SP) (SP) (3) 
("(") (SP) (SP) (3) 



(SP) (SP) (4) (CR) 
(SP) (SP) (5) 



(SP) (SP) (6) 
(SP) (SP) (4) 
(SP) (SP) (2) 
(SP) (SP) (5) 
(SP) (SP) (2) 
(SP) (SP) (4) 



ICR) 
(CR) 
(CR) 
(CR) 
(CR) 
(CR) 
(CR) 



<GIN-report-item>s 



<final-GIN-report-item> 



A typical <GIN-r«port-ltam> : 



l~» f 



(W) (a) (8) (SP) (&) (4) (SP) (SP) (SP) (6) (SP) (SP) (4) (CR) 



i 



:sig-char> 



:GIN— pick— report> 



i 

< EOM— indicator> 



A typical <flnal-GlN-r0poft-ltam> : 

(w) (CR)| 

i I 



<term— sig— char> 
<EOM— indicatoo 



Atypical <GW-pJck-r»poft> 



(a) 



(8) (SP) (&) (4) (SP) 



(SP) (SP) (6) 



(SP) (SP) (4) 



key which the 
operator pressed 



<xy-report> for 
the cursor position 



<int-report> for 
the segment number 



<int— report> for the pick-ID 
identifying a part of the segment 



Rguia 8-4. Typical < QIN-R«port-S«)UMie«> for the Pick Function. 
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STROKE FILTERING 

One feature useful with strokes is "stroke filtering." 
Both "distance filtering" and "time filtering" are avail- 
able. 

The distance filter prevents a GIN event from occurring 
until the operator has moved the pen (or tablet cursor) 
a minimum distance. (For this purpose, "minimum 
distance" means "a minimum change in x or y.") With 
distance filtering, a stationary pen does not cause the 
terminal to send many <GIN-stroke-report>s for the 
same point on the tablet. 

The time filter prevents a GIN event from occurring 
until a minimum time has eiapsed since the iasi GIN 
event. 

Stroke filtering is enabled with the < set-GIN-stroke- 
filtering> command: 

< set-GIN-stroke-filtering> 

= (ESCMD(F) 

< int. device-function-code> 
<int: minimum-distance> 

< int: minimum-time> 

Here, the first < int> parameter should be 1 0, which is 
the device-function code for the tablet device and 
stroke function. 

The second parameter specifies the distance filter. A 
new GIN event does not occur until the cursor has 
moved so that either its x-coordinate or its y-coordi- 
nate has changed by at least the distance specified in 
this parameter. If this parameter is zero, the distance 
filter is disabled. 

The third parameter specifies the time filter, in milli- 
seconds. A new GIN event does not occur until at least 
this number of milliseconds has elapsed since the 
preceding GIN event. 



INKING 

Another useful feature with strokes is "inking." For 
each stroke, the terminal draws line segments on its 
screen connecting the points specified in the <GIN- 
stroke-report> s for that stroke. 

(The inking feature may also be used with the locator 
function. For details, see the descripion in the 41 10 
Series Command Reference Manual of the < set-GIN- 
inking> command.) 

The inking feature is enabled with the <set-GIN- 
inking> command: 

<set-GIN-inking> = (ESC)(I)(I) 

< int: device-function-code> 

< int: t/>king-mode> 

The second parameter (inking mode) is one to enable 
inking and zero to disable inking. 

STROKE REPORT FORMAT 

During a stroke function, the terminal reports the 
coordinates of the tablet pen or cursor using the 
< GIN-report-sequence> format, in which the 
individual < GIN-stroke-report> s each report one 
coordinate position. The formal syntax is described in 
Section 4 of the 41 10 Series Command Reference 
Manual, under "<GIN-Report-Sequence> Message 
Type" and "<GIN-Stroke-Report> ." 

A Typical Stroke Report Sequence 

Figure 8-5 shows a typical stroke report sequence. 
This example assumes that the report-EOM-frequency 
setting is "more frequent," that the terminal is not in 
block mode, and that the < EOL-string> is set to (CR). 
Under these circumstances, each < GIN-Stroke-Re- 
port> is followed by a (CR). (For more information on 
the report-EOM-frequency setting, see Section 9. For 
information on the < EOL-strlng> , see Section 1 0.) 



Signature Characters 

In Figure 8-5, the <sig-char> and <term-slg-char> 
are (T) and (t), respectively. Thus, each < GIN-report- 
item> begins with the character (T), while the end of 
the <GIN-report-sequence> is marked with the char- 
acter (t). 
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A typical <GlN-raport-aaquanca> ; 



(T) (2) ("(")(,) (&) (") (;) (CR) 

(T) (J) ("(")(")")(&) (") (;) (CR) 

(T) (J) ("(")("(")(&) (") (;) (CR) 

(T) (J) ("(")(%) (&) (") (;) (CR) 



(T) (J) (2) (&) (=) (,) (,) (CR) 

- \{7) (J) (2) (,) (>) (,) (/) (CR)) 

(T) (O) (3) (!) (SP)(.) (/) (CR) 

(T) (Z) (&) (")") (/) (-) (")") (CR) 

(T) (J) (&) (")")(8) (-) (8) (CR) 

(T) (J) (") ($) (") (.) (+) (CR) 



(T) (J) (7) ( ) (> (.) (= ) (CR) 
(T) (0) (7) (")")(>) (J (<) (CR) 



>>< <GIN— report— item>s 

iui me nisi oiruKo 



/**" 






- < ijiN— report— item; 
for the second 
van a ibsu stroKe 



-< final— GIN— report— it8m> 



A typical < SIN - .-«pc-r' - Item > 
(T) (J) 

t " 



(T) (J) (2) (,) (>) (,) (/) (CR) 
v ' 



<sig— char> 

< GIN— stroke— report> 

<E0M— indicator> 

A typical < GIN -atroka-raport> : 

(J) (2) (,) (>) (,) (/) 

i 



"key" character: 

(M) or (Z) or (1 ) or (2) or (3) 
for the first point in a stroke; 

(J) for subsequent points; 

(0) for the last point 



< xy — report> for the 
cursor location 



Atypical 
t < 



(t) (CR) 



<term— sig— char>- 
<EOM -indicator;* - 



Figure 8-5. A Typical < QIN-Raport-8aquanca> for tha Stroke Function. 
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Key Characters 

After the (T), each < GIIM-stroke-report> begins with a 
"key" character. For the first point in a stroke, this is 
(M); for the last point in the stroke, it is (O). For 
intermediate points, the key character is (J). 

If the operator used the tablet cursor rather than the 
tablet pen, then the key character for the first point in 
the stroke would be (Z), (1 ), (2), or (3), depending on 
which of the cursor buttons is pressed. The intermedi- 
ate points would still have (J) for their key character, 
and the last point would still have (O) for its key 
character. 

There is a command, < set-tabiet-header-chars> , 
which can change the key characters for the last point 
and intermediate points of the stroke. This command 
does not change the key character for the first point of 
a stroke. See the 41 1 Series Command Reference 
Manual for details. 



< Xy- Report > s 

After the key character, each < GIN-stroke-report> 
contains five more characters. These comprise an 

< xy-report> telling the position of one point in the 
stroke. For more information on < xy-report> s, see the 

< xy-report> description in the 41 1 Series Command 
Reference Manual. 

Fitting More Than One Stroke Report On 
Each Line 

If you like, you can cause more than one < GIN-report- 
item> to occur on each "line of text" that the terminal 
sends to the host. To do this, you would issue a < sei- 
report-EOM-frequency: 0> command to make the 
terminal send (CR) characters "less frequently." You 
would also issue a <set-report-max-line-length> com- 
mand to specify the maximum length for each line of 
the report. (These commands are described in 
Section 9.) 

If the maximum report line length is 25, and the report 
EOM frequency is "less frequent," then a typical stroke 
report sequence is like that in Figure 8-6. 



(T)(Z) 
(THJ) 
(T)(J) 
(T)(J) 
(T)(J) 
(T)(J) 

(T)(J) 
(THJ) 
(T)(J) 
(T)(J) 
(THJ) 
(T)(0) 

(THJ) 
(THJ) 
(THJ) 
(THJ) 
(THJ) 
(THO) 



(7H+) 
(7)(") 
(1)(!) 
(0)(*) 
(.)(?) 
(/)(-) 

(8)(,) 
(8)(/) 
(8H-) 
(4H + ) 
( 1 H # ) 
(/)(") 

(3)(() 
(1)(-) 
(/)(,) 
(,)(") 
(+)("( 
(,)(') 



(-H//H6) 

")(!)(#)(3 

(8H#)(0) 

(2H$H+) 

(#)(■)(&) 

(+)(+)(2) 

(-H1H=) 
(-H2H1) 
(-H2H7) 
(2)(1H$) 
(*)(.)(2) 
")(=)(+)(+ 

(#)(%)(.) 
(:)(?)(-) 
(!)(?)(>) 
(.)(')(:) 

")(9H«)(: 

(>)(.)(•) 



(THJH7) 
) (THJH 

(THJH3) 
(THJH/) 
(THJH.) 
(THOHO) 

(THJH8) 

(THJH8) 

(THJH7) 

(THJH3) 

(THJHO) 

) 

(THZH3) 

(T)(J)(2) 

(THJH1) 

(THJH.) 

(THJH,) 

) (THJH 



(&)(-)(#) (6) (T)(JH7H!)(«H#H5HCR) 
6H#H1)(#H0) (T)(JH5H-H8H/n(/)(CR) 
(#)(/)(#) (3) (T)(J)(2)($)(SP)(#)(;)(CR) 
(,)(*)(?)(") (THJ)(.)(')(/)(&)(SP)(CR) 
(/)(%)(() (2) (T)(J)(.)(+)(4H*)C'HCR) 
(,)(&)(,)(?) 

(T)(Z)(8)(/)(-)(1)(9)(CR) 
(,)(-) (2) (#) (THJH8H/)(-)(2)(*)(CR) 
(,)(-)(2)(8) (T)(J)(8)(/)(-)(2)(:)(CR) 
(")("(") (2 )(,) (T)(JH5H#H>H1H:)(CR) 
(*)(*)(0)(+) (THJ)(2)(.)U)(/)(/)(CR) 
($)(4)(-)(5) (T) ( J) (0) (-)(%)(,) (8) (CR) 



' First stroke 



' Second stroke 



())())(«)(/) (T H J H3 )(#)("(")( J )(.)(CR) 
(!)(;)(%)(-) (T)(JH2H*)(-H%H,)(CFt) 
(.)(!)(*)(/) (T)(J)(0)(&)(#)(J)(iJ)(CR) 
(!)(!)(&)(-) (T)(J)(-)(&)($)(')(!)(CR) 
(!)(SP )(»(») (8) (T) (J) (+)(') (9 )(")") (9 )(CR) 
,)(/)(SP) (,)(!) (T)(J)(, )(«)(-)(-)(')( CR) 



Third stroke 



(t)(CR) 



N 



< final— GIN— report— item • 



Figure 8-6. Fitting Multiple Stroke Reports on Each Line. 



8-14 



<s> 



41 1 4 HOST PROGRAMMER'S 



GRAPHIC INPUT 



USING SEVERAL GIN DEVICES AT ONCE 



You can enable several GIN devices at once. For 
instance, the terminal can simultaneously be enabled 
for graphic input from the thumbwheels device, locator 
function (device-function code 0) and the tablet device, 
pick function (device-function code 9). 

SIGNATURE CHARACTERS 

When severs! graphic input dsvicss ars snswiSti, m@ 
reports which they send to the host are interleaved. In 
order that the host may parse the reports correctly, 
each device-function code should have its own distinct 
signature characters. For instance, you might assign 
(W) and (w) as the <sig-char> and <term-sig-char> 
for the thumbwheels, and assign (T) and (t) as the 
corresponding signature characters for the tablet. 



CURSORS 

The different device-function codes should have differ- 
ent cursors. If you use the default crosshair cursor 
("segment zero") for one device-function code, you 
should assign other segments to serve as the cursors 
for the other device-function codes. To do this, use the 
set-GIN-cursor> command: 

= (ESC)(l)(C)<int><int> 

Here, the first < int> parameter names the device- 
function code, and the second < int> parameter is the 
segment number for the segment being assigned as the 
graphics cursor. 
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Section 9 



REQUESTING REPORTS FROM THE TERMINAL 



This section describes the commands by which you 
can request reports from the terminal, and by which 
you can control the format of those reports. Not 
included here are descriptions of the graphic Input 
commands; those are described In Section 8. Topics 
i isrs srs! 

• Controlling the format of reports. This includes 
setting the signature characters, "EOM frequency," 
the maximum line length for reports, and so on. The 
commands described here affect GIN reports (de- 
scribed In Section 8) as well as the non-GIN reports 
described In this section. 



• Non-GIN reports. This section also covers how to 
obtain information on the terminal's settings, on the 
status of devices attached to the terminal, and on 
segments stored in the terminal's RAM memory. 



CONTROLLING THE FORMAT OF REPORTS 



REPORT SYNTAX 

For each report which the terminal sends the host 
computer, there is a syntax specified in the 41 1 
Series Command Reference Manual. You will need to 
consult that syntax description when you write a 
routine to parse that report. See the following descrip- 
tions in the Command Reference Manual: 

• <G(N-report-sequenee> 

• <GIN-locator-report> 

• <GIN-plck-report> 

• <GIN-stroke-report> 

• < Port-status-report> 

• < Segment-status-report> 

• <Terminal-settings-report> 

• <4010-GIN-report> 

• <4953-tablet-GIN-report> 



<EOM-INDICATOR>S 

Most of these reports have < EOM-lndicator> s in their 
syntax. Some of the < EOM-indicator> s are optional 
parts of the reports; in the syntax definitions, these are 
enclosed in square brackets (e.g., "[< EOM-lndica- 
tor>]"). Footnotes explain under what circumstances 
the optional < EOM-indlcator> s are included In the 
report message. 

If the terminal is in block mode (which requires Option 
01 ), then it sends an < EOM-indlcator> by terminating 
the block and setting the end-of-message bit In the 
< block-control-bytes> . This is described in 
Section 1 1 . 

If the terminal is not in block mode, then It replaces 
each < EOM-lndicator> with Its current < EOL- 
strlng> (end-of-llne string). This Is typically the single 
character, (CR), although other < EOL-atring>s may be 
selected with the < set-EOL-strlng> command. 

In either case (whether the terminal is In block mode or 
not), each < EOM-indlcator> marks the end of a "line 
of text" In a report message which the terminal sends 
to the host. 
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< SET-REPORT-EOM-FREQUENCY> 
COMMAND 

The < set-report-EOM-f requency> command lets you 
control how often the terminal sends < EOM-indica- 
tor> s in report messages. 

Consider, for instance, the syntax specified for < GIN- 
report-sequence> . This syntax is specified in the 
41 1 Series Command Reference Manual. For this 
discussion, the pertinent part of the syntax is as 
follows: 

< GIN-report -sequence > 
= [< GIN-report-item> . . J 

< finai-GiN-report-item> 

where 

< GIN-report-item> = [< EOM-indicator> ] 

[<sig-char>] 

< GIN-report> 

[<EOM-indicator>] 

By issuing a < set-report-EOM-frequency: 1 > com- 
mand, you can cause the terminal to send an < EOM- 
indicator> at the end of each < GIN-report-item> . 
(This is the < EOM-indlcator> shown In bold type.) 
That way, if the terminal is not in block mode, each 
individual <GIN-report> is followed with a (CR) (or 
other < EOL-string> ). If the terminal is in block mode, 
each individual <GIN-report> is in a block of its own. 

By issuing a < set-report-EOM-frequency: 0> com- 
mand, you can suppress the < EOM-indicator> s at the 
end of the < GIN-report-item> s. That way, several 
<GIN-report-ltem>s can fit on the same line of text. 

The < set-report-EOM-f requency> command has this 
syntax: 

< set-report-EOM-f requency> = (ESC)(I)(M)< lnt> 

The < int> parameter is one if < EOM-indicator> s are 
to be sent "more frequently;" it is zero if < EOM- 
indicator> s are to be sent "less frequently." 



< SET-REPORT-MAX-LINE-LENGTH> 
COMMAND 

If you decide to allow several reports to be sent on the 
same line of text (using the < set-report-EOM-frequen- 
cy: 0> command), then the question arises, "How 
many reports should the terminal send on each line of 
text?" Another way to phrase this is, "What is the 
maximum length permitted for each line of text?" 

You set the maximum line length permitted in reports 
with the <set-report-max-line-length> command: 

< set-report -max-line-length > 
= (ESC)(l)(L)<int> 

Here, the < int> parameter specifies the maximum 
number of characters allowed on each line of the report 
message, not counting any characters in the < EOM- 
indicator> which terminates the line. (If the terminal is 
not in block mode, the < EOM-indlcator> is the current 

< EOL-string> , as set by the < set-EOL-string> com- 
mand.) 

To see how the < set-report-max-line-length> com- 
mand affects the report messages which the terminal 
sends to the host, consider once again, the < GIN- 
report-sequence> syntax: 

< GIN-report-sequence> = [<GIN-report-item> . . J 

< f lnal-GIN-report-ltem> 

where 

< GIN-report-item> = [< EOM-lndlcator> ] 

[<sig-char>] 

< GIN-report> 
[<EOM-indicator>] 

If the < report -EOM-frequency> Is set to "less 
frequent," then the terminal does not send the optional 

< EOM-lndicator> at the end of each < GIN-report- 
item> . In that case, the <GIN-report-item> syntax Is 
simplified: 

<GIN-report-ltem> = t<EOM-indicator>] 
[<slg-char>] 

< GIN-report> 

The optional < EOM-indicator> at the start of each 
<GIN-report-ltem> (shown above in bold type) is only 
sent If the terminal's "maximum report line length" is 
about to be exceeded. This maximum line length Is 
determined by the <set-report-max-line-length> 
command. 
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Suppose, for instance, that the terminal is enabled for 
graphic input using the locator function, and that the 
maximum line length is set to 78 characters. Then each 
<GIN-report> in the<GIN-report-sequence> is a 

< GIIM-locator-report> , and consists of six characters. 
If the <sig-char> is not (NUL), it is sent before each 

< GIN-report> , so each < GIN-report-item> has seven 
characters, not counting the optional < EOM-indica- 
tor> . Without exceeding the maximum line length, 
eleven seven-character <GIN-report-item>s can fit on 
each line. 

When the terminal has sent eleven <GIN-report- 
item> s, it has filled up a line of text. If the terminal has 
a twelfth <GIN-report-item> to send, it begins by 
sending an < EQM-indicator> . This < EOM-indicator> 



serves to terminate the preceding line of text, so that 
the maximum line length is not exceeded. The remain- 
der of the <GIN-report-item> — the<sig-char> and 
<GIN-locator-report> — occupies the first seven 
characters of the next line of text. 

EXAMPLES 

Figure 9-1 shows two typical < GIN-report- 
sequence> s for the locator function. In the first part of 
the figure, the EOM-frequency is "more frequent," so 
that each < GIN-report-item> is on a separate line of 
text. In the second part of the figure, the EOM- 
frequency is "less frequent," and the maximum report 
line length is 25; this fits three seven-character <GIN- 
report-item> s on each line of text. 



C«HMHiHSPH"CH'H!HCR) 

(WHOH-HSPH")"H'H!HCR) 

( w HD) ( -HSPH ")")(%)(♦/ HCR) 

mrOHOHSPH-H.H-HCR) 

(W)(D){-)(SP)(")")(6H5)fCRJ 

(WHr))(-)(SP)(")")(5)(#)(CR) 

(WHDHiHSPH-CHSHOHCR) 

CWHr))UHSPH"C"H'H!)CCR) 

(W) (M) {«,) (SP) ("(")( 2H*HCR) 

( WHO H#H 5P H%)( 2 HRHCR) 

(«f)(P)(#)(SP)(*)(i)(6)(CR) 

(0(n)UHSPH"("HlH&HCR) 

CO(DHSPHSPHSPHOH-HCR) 

(MHWHMHSPHSPHSPH3H1HCR) 

C WHDH&MSP )("(")( 2 H«»HCR) 

(«HMH$)(SPH6H5PHSP)fCR) 

(tf)CDH'HSP)UH'M!HCR) 

(»0 (M)(«HSP) (♦.)(« HI )(CR> 

(iHOH.HSPHOmrCHCR) 

(tfHXH#HSPH$H?H"("HCR) 

(w)(CR) 

A. < Set -EOM- Frequency: 1 > 



(*HMHO(SPHH"Hnc.!HWHDH-HSPH")"H'H!HWHDH-HSPH ,, >"mH*/HCR) 

(W)(n)C0HSPH-)(.)(" , )tWHD)(-HSP)(-)")(6)(5)(W)(D)f-)(SPH")«)(5)(l)(CR) 

d*)(r))(fc)(SP)("C")(5)(»)(W)CD)(i)(SPH»(")(')(J)(W)(M)fs,HSP)("(")(2)(8)(CR) 

(«HDH#)(SP)(*)(2H8)(WHD)(#)(SP)(%)(lHsHWHD)((l)(SP)C(")(lHfi)(CR) 

(•J)fD)(SP)(SP)(SP)(0)(-)(M)(W)(M)(SP)(SP)(SP)C1)fl)CWHD)(t)CSP)("(")(2)(B)(CP) 

(»')f*')(»)(SPH6)(SP)(SP)fW)(0)CHSP)(J)(»)(l)(W)(M)f#)(sp){*.)(5)(«)(CR) 

(W)(D)(.HSP)(»)(?H"(")(»0(X)f|)(SP) (•)(?)("(") (wHCR) 

B. < Set- EOM -Frequency: 0>,< Set-Report-Max-Line-Length: 2S> 
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Figure g-1 . Controlling the Format of a < QIN-Report-8equenee> . 
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Likewise, Figure 9-2 shows two < errors-report> se- 
quences which the terminal might send in response to 
a < report-errors> command. (The < report-errors> 



command is described later in this section and in the 
the Command Reference Manual. For details of the 
< errors-report> syntax, see the 41 1 Series Com- 
mand Reference Manual.) 



CJ)fN)(KH!)f: 

(N)tn)(THt)ti 
COfOldKDf! 



•l)CSP5(SPl(2HSP)fSP)f 1HCR) 

:i>(SP>(SPl(2)(5P)(SP)(l) tCBl 

:iHSP)(SPH2HSP)(SP)tncCRl 

n(SPH. < ?PH?)fS"){SPHl)[CR) 

ncSPHSPH?) fSP)(SP)f2) tCR) 

( "i ) ( 7. > ( n u o h o > c sp ) ( sp u n t sp ) f sp ) r n c r p ) 

(rOfCH) 



A. < Set— EOM— Frequency: 1> 



CM)fN)CR)(2)ri)(SP)(SPlC2)fSP)fSP)f l)(M)fN)(P)(l)(1)(5PHSP)(2HSP)(SP)(l)(CR) 
C^)(0) tTHI H lHSPHSPl(2)fSP)fSP)f lt(N)(n)(P)t2Ht HSPMSP) (2HSPHSPH1) (CP ) 

( orn)crnci )f ncspHsp)(2)fsP)(SP)f2>(N)(ZHv)coi(")(sp)rsP)(ncsPH.'>PHi )fn)(CR) 
B. < Set— EOM— Frequency: 0>,<Set— Report— Max— Line— length: 25> 



3675-38A 



Figure 9-2. Controlling the Format of < Errors-Report > Messages. 
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<SET-REPORT-SIG-CHARS> COMMAND 

The < set-report-sig-chars> command sets the <sig- 
char> and <term-sig-char> signature characters, 
which are used in <GIN-report-sequence> messages 
and also in non-GIN report messages. The command 
has the following syntax: 

< set-report -sig-chars> 

= (ESC)(l)(S)<int><intxint> 

The first < int> parameter specifies the type of report 
for which the signature characters are being specified. 
For GIN reports, this is a GIN device-function code. 
(See Section 8 for information on device-function 
codes.) For other reports ("non-GIN" reports), this 
parameter is minus three. (All non-GIN reports have the 
same <sig-char> and <term-sig-char> signature 
characters.) 



If this parameter is minus one, then the < set-report- 
sig-chars> command sets the signature characters for 
all reports: all GIN device-function codes, and all non- 
GIN reports as well. 

The second and third < int> parameters specify the 
ASCII characters to be used as the < sig-char> and 
<term-sig-char> in the reports of the type specified 
by the first parameter. Each character is specified by 
its numeric equivalent. For instance, < int: 65> repre- 
sents the (A) character, since the ASCII decimal 
equivalent of A is 65. 

Setting a signature character to (NUL) — ASCII decimal 
equivalent of zero — causes that character not to be 
sent in reports to the host computer. 

For more information, see the description in the 41 1 
Series Command Reference Manual of the < set- 
report-sig-chars> command. 



NON-GIN REPORTS 



Besides the commands for graphic input, the following 
commands cause the terminal to send report messages 
to the host computer: 

• < report-device-status> 

• < report-errors> 

• < report-port-status> 

• < report-segment-status> 

• <report-terminal-settings> 

• < report-401 0-status> 

The following descriptions summarize the purposes of 
these commands. For more information, see the de- 
scriptions of these commands in the 41 1 Series 
Command Reference Manual. 

<REPORT-DEVICE-STATUS> COMMAND 

The < report -devlce-status> command causes the 
terminal to send a < device-status-report> to the host 
computer. The < device-status-report> tells the host 
certain status information about the peripheral device 
specified In the < report-device-status> command. 
The command has the following syntax: 

< report-device-status> = (ESC)(J)(0)<strlng> 

If Option 10 (Three Port Peripheral Interface) Is 
installed, the < string> may be "PO:", "P1 :", or "P2:", 
to specify one of the RS-232 peripheral ports. If Option 



42 or 43 (disk drive or drives) is installed, the 

< string> may be "FO:" or "F1 :", to specify a particular 
flexible disk drive. 

For more details, see the following descriptions in the 
41 1 Series Command Reference Manual: 

• < Report-device-status> command 

• < Devlce-status-report> message type 

<REPORT-ERRORS> COMMAND 

The < report-errors> command causes the terminal to 
send an < errors-report> message to the host compu- 
ter. In that message, the terminal reports the eight 
most-recently detected error codes, their severity 
levels, and how many times each error was detected. 
The command has the following syntax: 

< report-errors > = (ESCMKMQ) 

For details, see the following descriptions In the 41 1 
Series Command Reference Manual: 

• < Report-errors> command 

• < Errors- report > message type 

See also Appendix C of the Command Reference 
Manual, "Error Codes." 
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<REPORT-PORT-STATUS> COMMAND 

The < report -port-status> command is available only if 
Option 1 0, the Three Port Peripheral Interface, is 
installed. The command has the following syntax: 

< report-port-status> = (ESC)(P)(Q)<string> 

Here, the < string> parameter is "P0:", "P1 :", or "P2:". 
It names the RS-232 peripheral port for which a status 
report is requested. In response to the command, the 
terminal sends a < port-status-report> message to the 
host computer. This message contains information 
about various settings for the specified peripheral port: 
baud rate, parity, flagging mode, etc. 

For details, see the following descriptions in the 41 1 
Series Command Reference Manual: 

• < Report-port-status> command 

• < Port-status-report> message type 

< REPORT-SEGMENT-STATUS> 
COMMAND 

The < report-segment-status> command causes the 
terminal to send a <segment-status-report> message 
to the host computer. The command has the following 
syntax: 

< report-segment-status> 

= (ESC) (S) (Q) < intx char-array> 

Here, the < int> parameter names the segment for 
which status information is requested. The parameter 
may be in the range from 1 to 32767, in which case 
information about one specified segment is returned. 
Or, the parameter may be one of the "special segment 
numbers" described in Section 6: "—1 " means "all 
segments," "—2" means "default values for segments 
not yet defined," and "-3" means "all segments in the 
current segment matching class." 

The < char-array> tells the terminal which information 
about the specified segment (or segments) is desired. 

For details, see the following descriptions in the 41 1 
Series Command Reference Manual: 

• < Report-segment-status> command 

• < Segment-status-report> message type 



< REPORT-TERMINAL-SETTINGS> 
COMMAND 

The <report-terminal-settings> command is an ex- 
tremely versatile command by which the host can 
obtain a wealth of information about the terminal's 
settings. The command has the following syntax: 

< report-terminal-settings> 

= (ESC)(l)(Q)<charxchar> 

Here, the two < char> parameters comprise the op 
code for one of the terminal's commands. The terminal 
responds by sending the host a <terminal-settings- 
report> telling what the current values are for the 

o^dwiiiuu oouiiiiciiiu 5 paiaiiioioio. 

Example: Querying the Terminal for Its 
Baud Rate Settings 

For instance, the < set-baud-rates> command has this 
syntax: 

< set-baud-rates> 

= (ESC)(N)(R)<int+xint+> 

Since the op code for this command is NR, the host can 
learn the terminal's baud rates by issuing the following 
command: 

< report-terminal-settings: (N),(R)> 
= (ESC)(I)(Q)(N)(R) 

In response to this command, the terminal sends the 
host a < terminal-settings-report> , as follows: 

< terminal-settings-report> 

= [<sig-char>] 
(N)(R) 
<int-report: transmit-rate> 

< int-report: receive-rate> 

< EOM-indicator> 
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Assume that the < sig-char> for non-GIN reports is 
(T), that the terminal's < EOL-string> is (GR), that the 
terminal is not in block mode, and that it is set to 
transmit characters at 300 baud and receive them at 
600 baud. Under these circumstances, the <termlnai- 
settings-report> would be as follows: 

< terminal-settings-report> 

= (T) 
(N)(R) 

<int-report: 300> 
<int-report: 600> 
(CR) 

= (T) 
(N)(R) 
(SP)(1)(>) 
(SP)(C)(<) 



<REPORT-4010-STATUS> COMMAND 

The < report-401 0-status> command is provided for 
compatibility with TEKTRONIX 4010 Series terminals. 
It has the following syntax: 

< report-401 0-status> = (ESO(ENQ) 

In response to this command, the terminal sends a 
<401 0-status-report> to the host computer. For de- 
tails, see the following descriptions in the 41 1 Series 
Command Reference Manual: 

• < Report-401 0-status> command 

• < 401 0-status-report> message type 



= (D(N)(R)(SP)(1)(>)(SP)(C)(<)(CR) 

Special Inquiry Codes 

There are also a number of "special inquiry codes," 
which can be used instead of command op codes in the 

< report-terminal-settings> command. For instance, 
you can find out how much free memory the terminal 
has available by the "?M" inquiry code: 

< report-terminal-settings: (?)(M)> 
= (ESC)(I)(Q)(?)(M) 

For information on these inquiry codes, and for full 
details on the < report-terminal-settings> command, 
see the following descriptions in the 41 1 Series 
Command Reference Manual: 

• <Report-terminal-settings> command 

• <Terminal-settings-report> message type 
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COMMUNICATIONS SETTINGS 



INTRODUCTION 



This section tells how to control the 41 1 4's standard 
communications settings. Not included are the settings 
associated with Option 01 (Half Duplex and Block 
Mode); those settings are described In Section 1 1 . 

To n ios discussed in this section are: 

• The most important communications settings: data 
rates, echo, parity, and number of stop bits. 

• Less important settings: the break time, and coping 
with (DEL) filler characters which some hosts send. 

• Full duplex data communications. 

• The terminal's communications input queue, and the 
handshaking protocols used to keep it from over- 
flowing. 



• The concept of "lines of text" in data sent from the 
terminal to the host, and the transmit delay that 
occurs at the end of each such line. 

All the terminal's communications settings (those set- 
tings described in this section or in Section 11 ) are 
remembered by the terminal even when it is turned off. 

All the communications settings can be set by the 
operator, using SETUP mode commands. See the 41 1 4 
Operator's Manual for details. 
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THE MOST IMPORTANT COMMUNICATIONS SETTINGS 



DATA RATE COMMANDS 

< Set-Baud-Rates > Command 

You can set the 41 14's host-to-terminal and terminal- 
to-host data transmission rates (also known as "baud 
rates"). Normally, these rates should be set by the 
terminal's operator, using the SETUP mode BAUD 
command. However, an "escape sequence" <set- 
baud-rates> command does exist. 




It is usually unwise to issue the < set-baud- 
rates> command from the host computer. (The 
terminal cannot understand the command unless 
its baud rates are already set correctly for 
communicating with the host; changing the baud 
rates could only serve to make further communi- 
cation with the host impossible.) 

The < set-baud-rates> command, may, however, 
be included in a file of terminal commands stored 
in the terminal's optional disk drives. That way, 
the operator can initialize the terminal for 
operation with a particular host computer by 
typing a LOAD command (in SETUP mode) to 
load that command file into the terminal. 

The < set-baud-rates> command has this syntax: 
< set-baud-rates> = (ESC)(N)(R)<intxint> 

(For more details, see the < set-baud-rates> command 
description in the 4110 Series Command Reference 
Manual.) 



< Set-Transmit -Rate-Limit > Command 

You can specify a "transmit data rate limit" — an 
effective maximum speed for terminal-to-host commu- 
nications, which may be less than the rate at which the 
terminal sends each individual character. A transmit 
data rate limit of 300, for instance, means that the 
terminal, in sending characters to the host, will space 
those characters apart for an effective average data 
rate of 300 bits/second. This is useful at high baud 
rates, where the host computer's input processor may 
not be able to accept characters "back to back" at the 
full data rate. 

For instance, even though the terminal may be set to 
transmit each character at, say, 9600 bits/second, it 
can space its characters apart for an average data 
transmission rate of only 300 bits/second. 

The <set-transmit-rate-limit> command has this syn- 
tax: 

<set-transmit-rate-limit> = (ESC)(N)(X)<int> 

Here, the < int> parameter specifies the maximum 
effective transmit rate in bits per second. 

For more details, see the description of the < set- 
transmit-rate-limit> command in the 41 10 Series 
Command Reference Manual. 



Examples 

Table 1 0-1 shows examples of the < set-baud-rates> 
and < set-transmit-rate-limit> commands. 



Table 10-1 
SETTING THE TERMINAL'S DATA RATES 



Example 


Description 


< set-baud-rates: 1 200, 1 200> 

= (ESC)(N)(R)<lnt:1200><int:1200> 

= (ESC)(N)(R) (A)(K)(0) (A)(K)(0) 


Sets the terminal's transmit (terminal-to-host) and receive (host-to-termlnal) data 
rates to 1 200 bits/second. 

(For information on how the < int: 1 200> parameters expand to (A)(K)(0), see the 
description of the < lnt> and < int+ > parameter types in the 41 1 Series 
Command Reference Manual.) 


< set-baud-rates : 1 200, 800 > 

- (ESC)(N)(R)<int:1200xint:600> 

- (ESCXNXR) (AHKX0) (e)(8) 


Sets the terminal's transmit (terminal-to-host) rate to 1 200 bits/second, and its 
receive rate to 600 bits/second. 


<set-xmt-llmlt:300> 

- (ESC)(N)(X)<int:300> 

- (ESC)(N)(X)(R)(<) 


Although the 41 1 4 sends each character at the rate specified in the most recent 
<set-data-rates> command, it spaces the characters apart for an effective average 
rate of 300 bits/second (about 30 characters/second). 
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<SET-ECHO> COMMAND 

Except in LOCAL mode or SETUP mode, when you type 
on the 41 1 4's keyboard, the characters typed go to the 
host computer. They do not necessarily appear on the 
terminal's screen. They only appear on the screen if (a) 
the host (or modem) sends the same characters back 
to the terminal — provides a "remote echo" — or (b) the 
terminal provides its own "local echo" of the transmit- 
ted characters. 

The operator can specify whether the terminal provides 
a local echo by means of the ECHO command in 
SETUP mode; see the 41 1 4 Operator's Manual for 
details. This command can also be issued by the host, 
or by a command file < load> ed from the terminal's 
optional disk drive. The command syntax is as follows: 

<set-echo> = (ESC)(K)(E)<int> 

In this command, if the < int> is 1 , the terminal 
provides its own echo; if the < int> is zero, the terminal 
does not. In the latter case, it is the responsibility of the 
host computer (or other external equipment) to provide 

the echo. 

Table 10-2 shows examples of the <echo> command. 
For more details, see the command description in 
Section 1 0. 



<SET-PARITY> COMMAND 

The 41 1 4's parity setting controls how the 41 1 4 sets 
the eighth bit (parity bit) In each character it sends to 
the host. (Except in block mode, the 41 1 4 ignores the 
parity bit in characters it receives from the host.) 

The choices on the use of the eighth bit are: 

• Low parity. When the 41 1 4 sends a character to the 
host, it sets the parity bit to zero. 

• Odd parity. When sending a character to the host, 
the 41 1 4 sets the parity bit so that there are an odd 
number of ones in the character's eight bits. 

• Even parity. When sending a character to the host, 
the 41 1 4 sets the parity bit so that there are an even 
number of ones in the character's eight data bits. 

• High parity. Sets the parity bit to one in characters it 
transmits to the host. 

• "Data" parity. The parity bit is used for data, just as 
are the other seven bits In each eight-bit character. 
(This mode is not normally used, since it Implies a 
different code than the standard ASCII seven-bit 
code.) 

The host computer controls the terminal's parity setting 
with the < set-parity> command: 

<set-parlty> = (ESC)(N)(P)<int> 

where the < int> is 0, 1 , 2, 3, or 4 for "low parity," "odd 
parity," "even parity," "high parity," and "parity bit used 
for data," respectively. 



Table 10-2 
SETTING THE TERMINAL'S LOCAL ECHO 



Example 


Description 


<echo:0> - (ESC)(K)(E)<int: 0> 
- (ESC)(K)(E) (0) 


Specifies "no local echo." Any echo must be provided by the modem or the host 
computer. 


<echo: 1> - (ESC)(K)(E)<lnt: 1> 
- (ESC)(K)(E) (1) 


Specifies "local echo." The 41 1 4 displsys the characters It sends to the host. 
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<SET-STOP-BITS> COMMAND 

In communicating with the host, the terminal sends and 
receives each character serially, as a sequence of 10 
or 1 1 bits. (This is called "asynchronous serial" data 
communications.) The first bit for each character is a 
start bit, always a zero (or "space") bit. The next seven 
bits determine the particular ASCII character, after 
which comes a parity bit, described earlier. The 
character ends with one or two "stop bits," which are 
always ones (or "mark" bits). The communications line 
then remains in the marking condition until the start bit 
for the next character. 

In receiving characters from the host, the terminal will 
aiways operate correctly, regardless of whether the 
host sends one or two stop bits in each character. 



The terminal includes one or two stop bits in each 
character it transmits to the host. The number of stop 
bits can be set with the <set-stop-bits> command: 

<set-stop-blts> = (ESC)(N)(B)<int> 

Here, the < int> parameter specifies the number of 
stop bits; it must be either one or two. 

The operator can also set this parameter, with the 
SETUP mode STOPBITS command. See the 41 1 4 
Operator's Manual for details. 



LESS IMPORTANT COMMUNICATIONS SETTINGS 



<SET-BREAK-TIME> COMMAND 

Pressing the BREAK key sends a "break" signal to the 
host computer. This signal is not an ASCII character, 
but it is a signal to the host computer. In full duplex 
communications, the break is sent by holding the 
communications line in the "space" condition for 
longer than the duration of a single ASCII character. In 
half duplex with supervisor mode (described in Section 
1 1 ), a break is sent by turning off the secondary 
carrier. 

As shipped from the factory, the break signal is set to 
last 200 milliseconds. This is adequate for most host 
computers. The <set-break-time> command lets you 
change this value for use with hosts for which 200 
milliseconds is too short or too long. The command has 
the following syntax: 

<set-break-tlme> - (ESC)(N)(K)<int> 



Here, the < int> parameter specifies the number of 
milliseconds that the break signal is to last. This value 
can also be set by the operator, using the SETUP mode 
BREAKTIME command; see the 4114 Operator's 
Manual for details. Like all communications settings, 
the break time is remembered by the terminal even 
when it is turned off. 

Some host computers are intolerant of break signals. 
(They may, for instance, respond to a break by logging 
the user off and disconnecting the telephone line.) For 
such hosts, it may be convenient to set the break time 
to zero; this causes the terminal not to send a break 
signal. 

Besides sending the break signal, the BREAK key has 
a few other effects. For details, see the description of 
the BREAK key in the 41 10 Series Command Refer- 
ence Manual. 
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COPING WITH (DEL) FILLER 
CHARACTERS 

The Problem 

Some host computers Intersperse (DEL) characters 
(also known as (RUBOUT) characters) among the 
characters they send to a terminal. These extra "filler" 
characters are inserted automatically by the host 
operating system, so that the user's applications 
program has no control over them. Since the 41 1 4 
interprets (DEL) as a valid character in < int> , 
< int+ > , and < xy> parameters, these extra (DEL) 
characters can cause problems. 



The Remedy 

The 41 1 4 terminal includes two features which help 
you cope with this problem. Firstly, the terminal 
accepts the character sequence (ESCH?) as a syno- 
nym for (DEL). Secondly, the < ignore-delete> com- 
mand causes the terminal to ignore any (DEL) charac- 
ters which the host may send it. (It does not, however, 
ignore (ESCH?) sequences.) 

Thus, if your host uses (DEL) as a filler character, you 
should do the following two things: 

1 . Write your device driver routines so that they 
always send (ESCH?) when they would otherwise 
send the (DEL) character. The routines to change 
are the ones which issue < int> , < int+ > , and 
<xy> parameters. 

2. At the start of each applications program, send an 
< ignore-deletes> command to the terminal. 

For more Information on the < lgnore-deletes> 
command, see Its description in the 41 10 Series 
Command Reference Manual. 



FULL DUPLEX DATA COMMUNICATIONS 



Many time-sharing systems use the "full duplex, re- 
mote echo" data communications protocol. "Full du- 
plex" means that the data communications line can 
simultaneously support transmissions In both direc- 
tions. "Remote echo" means that the host "echoes" 
back to the terminal each character which the terminal 
sends. It Is the echo, rather than the original 
transmitted character, which is displayed on the termi- 
nal's screen. An echo from the host computer is 
possible only In a full duplex system. 



If the 41 1 4 Is not equipped with Option 01 , then it is 
always configured for full duplex data communications. 
To use full duplex, remote echo data communications, 
It is only necessary that the terminal's local echo be 
turned off (with a < set-echo: 0> command). 

If the 41 1 4 has Option 01 installed, then it can be used 
with either full duplex or half duplex data communica- 
tions. In that case, a < set-duplex: 0> command is 
used to set the terminal for full duplex operation. The 
< set-duplex> command is described In Section 1 1 . 
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THE COMMUNICATIONS INPUT QUEUE AND "HANDSHAKING" 

PROTOCOLS 



<SET-QUEUE-SIZE> COMMAND 

The terminal has an input buffer, or queue, where it 
accumulates the characters it receives from the host 
computer. When characters arrive faster than the 
terminal can process them, the terminal stores them in 
its communications input queue until it has a chance to 
process them — or until the memory allocated for that 
queue is exhausted. (If the queue memory is exhaust- 
ed, incoming characters are lost.) 

For instance, the terminal cannot display characters 
while it is in the process of erasing its screen. 
Therefore, while the screen is being erased (as, for 
instance, in response to the PAGE key), any characters 
coming from the host are stored in the input queue until 
the erase operation is finished. When the screen 
erasure is complete, the terminal reads the characters 
from the queue and displays them. 

Again, while in SETUP mode the terminal does not 
display characters coming from the host. Instead, such 
characters accumulate in the Input queue. The terminal 
waits to process those characters until the operator 
presses the SETUP key to remove the terminal from 
SETUP mode. The same is true for LOCAL mode. 

As shipped from the factory, the communications 
queue can hold up to 300 ASCII characters. However, 
this value can be changed with the < set-queue-size> 
command: 

<set-queue-size> = (ESC)(N)(Q)<int+> 

Here, the < int+ > parameter specifies how many 
characters the input queue can hold. 

The < set-queue-size> command can also be typed by 
the operator, as the SETUP mode QUEUESIZE 
command. See the 41 1 4 Operator's Manual for details. 



THE NEED FOR HANDSHAKING 

The 41 1 4 can display simple alphanumeric text and 
graphics only up to a maximum continuous data rate of 
1 9200 baud (1 9200 bits per second). At higher data 
rates, or for more complex operations, some "hand- 
shaking" protocol should be used to prevent the 
terminal's communications input queue from 
overflowing. 

Even at slow data rates, it may be prudent to use a 
handshaking protocol. The terminal can take an appre- 
ciable amount of time to execute some commands 
which can be issued using only a very few characters. 
Examples are the < include-copy-of-segment> , 
< directory> , < load> , and < save> commands. If a 
handshaking protocol is not used, the terminal's input 
queue may overflow while executing such commands. 

Such a handshaking protocol might be as simple as 
issuing < report-4010-status> from time to time, and 
waiting to receive the reply before sending more 
characters to the terminal. Alternatively, either of two 
data communications protocols may be used: flagging 
mode or block mode. (Or both modes may be used at 
the same time.) Either of these communications 
protocols will prevent the terminal's input queue from 
overflowing. (Block mode is available only if the 
terminal is equipped with Option 01 . It is described in 
Section 1 1 .) 
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<SET-FLAGGING-MODE> COMMAND 

The terminal's flagging mode can be set by the 
operator using the SETUP mode FLAGGING command. 
(See the 411 4 Operator's Manual for details.) It can 
also be set by the host computer, using the < set- 
flagging-mode> command: 

<set-flagging-mode> = (ESC)(N)(F)<int> 

Here, the < int> parameter specifies the flagging 
mode; it is in the range from to 4. 

Mode (No Flagging). DC1/DC3 and DTR/CTS flag- 
ging are both disabled. 

Mode 1 (DC1 /DC3 Flagging for Input). The terminal 
uses the "DC1 /DC3" flagging protocol when receiving 
characters from the host. 

If the host is sending characters to the terminal faster 
than the terminal can process them, so that the 
terminal's input queue Is in danger of overflowing, then 
the terminal sends the host a (DC3) character. The host 
is then expected to suspend transmission of charac- 
ters to the terminal. 

When the terminal is ready for more characters, it 
sends the host a (DC1 ) character. This signals the host 
that it may resume transmission of characters to the 
terminal. 

Mode 2 (DC1 /DCS nagging for Output). The 

terminal uses the "DC1/DC3" flagging protocol when 
transmitting characters to the host. 

The host can send the terminal a (DC3) character when 
the host's input buffer Is in danger of overflowing. The 
41 1 4 sends at most one or two more characters and 
then stops transmitting to the host. 

When the host is ready for more characters, it sends 
the terminal a (DC1) character. When the 41 1 4 re- 
ceives a (DC1), It resumes transmission to the host. 



Mode 4 (DTR/CTS Flagging). In DTR/CTS flagging, 
the terminal uses two signal lines at the RS-232 
connector to regulate the flow of data between the 
terminal and the host computer. These signal lines are 
DTR (Data Terminal Ready) and CTS (Clear To Send). 

NOTE 

DTR/CTS flagging is usually not practical when 
the host is connected to the terminal over 
telephone lines by the use of modems. In such 
circumstances, the host does not have direct 
access to the DTR and CTS si n nal lines. This 
flagging mode is only practical if the host is 
connected directly to the terminal. 

In DTR/CTS flagging, the terminal indicates that it 
wishes to transmit data by asserting RTS (Request To 
Send); that is, it places a positive voltage on the RTS 
signal line at the RS-232 connector. If the host is ready 
to receive the data, it asserts CTS (Clear To Send). The 
terminal is only allowed to transmit when CTS is 
asserted. 

Should the terminal be transmitting characters faster 
than the host can process them, so that the host's input 
buffer is in danger of overflowing, the host can drop 
CTS (place a negative voltage on the CTS signal line). 
When the host is ready to receive more characters, it 
asserts CTS again, and the terminal resumes its 
transmission. 

When receiving characters from the host, the terminal 
uses the DTR (Data Terminal Ready) signal line In the 
same way that the host uses the CTS line. If the host is 
sending characters faster than the ierminai can pro- 
cess them, so that the terminal's input queue is in 
danger of overflowing, then the terminal drops DTR, (It 
places a negative voltage on the DTR signal line.) The 
host is then expected to stop transmitting to the 
terminal. When the terminal is ready for more charac- 
ters, it asserts DTR (places a positive voltage on the 
DTR line), and the host resumes its transmission to the 
terminal. 



Mode 3 (DC1/DC3 Flagging for Both Input and 
Output). The terminal uses the DC1 /DC3 flagging 
protocol both when receiving characters from the host 
and when transmitting characters to the host. 
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PROMPT MODE 

Besides flagging mode (just described) and block 
mode (described in Section 11 ), the terminal has a 
third handshaking protocol: prompt mode. 

The prompt mode protocol is useful for preventing the 
host's input buffer from overflowing when the terminal 
has much data to send to the host. However, prompt 
mode does not protect the terminal's input queue from 
overflowing when the host sends data to the terminal. 
For that, you should use flagging mode or block mode. 

Prompt Mode Operation 

When the terminal is in prompt mode, it waits to send 
each line of text until it receives a prompt string from 
the host computer. (The prompt string is a sequence of 
ASCII characters, determined by the most recent <set- 
prompt-string> command.) 

On receiving the prompt string, the terminal waits for 
the "transmit delay" amount of time and then sends 
one line of text to the host computer. Here, "one line of 
text" means all the characters it has to send, up to and 
including the next < EOM-char> or < EOL-string> . 
This is described in more detail later in this section. 
Typically, this means all characters up to and including 
the next carriage return (CR) character. 

The prompt string must be the last characters received 
by the terminal, or else the terminal will not recognize it 
as a prompt. 

The following steps summarize prompt mode operation: 

1 . The terminal sends a line of text, up to and 
including the < EOM-char> or < EOL-string> that 
marks the end of the line. 

2. The terminal receives a prompt string from the 
host. 

3. The terminal waits for the transmit delay. 

4. Steps 1 through 3 are repeated again and again, 
until the terminal is removed from prompt mode. 



End of a Line of Text. As just mentioned, the end of a 
line of text occurs when the terminal encounters an 
< EOM-char> or < EOL-strlng> in the data It is 
sending to the host. 



Typically, an < EOM-char> is a (CR) chracter typed by 
the operator or occurring in a file being transferred to 
the host with the <copy> command. (The <copy> 
command is described in Section 1 2.) However, other 
characters can be chosen as the < EOM-char> . For 
details, see the description of the <set-EOM-chars> 
command in the 41 10 Series Command Reference 
Manual. 

If the terminal is not in block mode, then it sends 

< EOL-string> s wherever < EOM-indicator> flags 
occur in a report it is sending to the host computer. 
(Examples of such reports are <GIN-report-se- 
quence>s and <terminal-settings-report>s. See Sec- 
tions 8 and 9 for details; see also the Command 
Reference Manual for the syntax of the different report 
messages.) The <EOL-string>s are typically (CR) 
characters, although other characters or character 
sequences can be chosen with the <set-EOL-string> 
command. 

If the terminal is in block mode, it sends an < EOL- 
string> at the end of each line of a block being sent to 
the host. (Block mode is described in Section 1 1 .) 

< Prompt- Mode > Command 

You can put the terminal in prompt mode or remove it 
from prompt mode with the < prompt-mode> com- 
mand: 

< prompt-mode> = (ESC)(N)(M)<int> 

If the < int> parameter is zero, the terminal exits 
prompt mode. (It is not an error to send a < prompt- 
mode: 0> command when the terminal is already out 
of prompt mode.) 

If the < int> parameter is two, the terminal enters 
prompt mode as soon as it processes the < prompt- 
mode: 2> command. Even if the terminal is In the midst 
of sending characters to the host, it stops sending 
those characters. (It waits for a prompt from the host 
before resuming transmission.) 

If the < lnt> parameter is one, and the terminal is 
sending characters to the host, then it finishes sending 
the current line of text before entering prompt mode. 
That is, the terminal continues to transmit characters 
until it encounters an < EOM-char> or < EOL-string> 
in the data being sent to the host. After sending that 

< EOM-char> or < EOL-string> - typically, the (CR) 
character — the terminal enters prompt mode. 
Thereafter, It will not send more characters until the 
transmit delay elapses and It receives a prompt from 
the host. 
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The operator can remove the terminal from prompt 
mode by typing the SETUP mode command, PROMPT- 
MODE NO, or by pressing the CANCEL key. The host 
can remove the terminal from prompt mode by sending 
the < cancel> command or the < prompt-mode: 0> 
command. 

<Set-Prompt-String> Command 

The prompt string is determined by the <set-prompt- 
string> command: 

<set-prompt-string> = (ESC)(N)(S)<int-array> 

Here, the < int-array> is an array of up to ten integers. 
Each integer in the array is the numeric equivalent of 
an ASCII character. 



For instance, to set the prompt string to "GIMME:," you 
can send the following command to the terminal: 

< set-prompt-string: "GIMME:"> 
= (ESCMNMS) 

<int-array: (71, 73,77,77,69,58) > 

= (ESCMNMS) 
<int: 6> 

< int: 71 >< int: 73> < int: 77> 
< int: 77> < int: 69> < int: 58> 

= (ESCMNMS) (6) (D)(7) (D)(9) 

Wn=) KUI\= I KUIKO) \\Jl\-l 

Here, the integer 6 is the number of < int> s in the 

< int-array> . The integers 71 , 73, 77, 77, 69, and 58 
are the decimal equivalents of the ASCII characters 
(G),(l),(M),(M),(E),and(:). 
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The preceding description of prompt mode mentioned 
the concept of a "line of text" in data being sent to the 
host, and the transmit delay which occurs after the 
terminal sends each such line of text. The following 
description explains these in more detail. 

THE TRANSMIT BUFFER 

The terminal has an internal transmit buffer to hold any 
characters which are waiting to be sent to the host 
computer. When the operator types on the keyboard, 
the characters he or she types go into the transmit 
buffer. Likewise, when the terminal has a report 
message to send to the host, the characters of that 
message go into the transmit buffer. 

The terminal sends the characters in the transmit 
buffer to the host a line at a time; that is, it reads 
characters from the transmit buffer and sends them to 
the host until it encounters the end of a line of text. 
Then it waits for a short time to elapse (the "transmit 
delay") before sending the next line of text. If in prompt 
mode, the terminal also waits to receive a prompt from 
the host before sending the next line of text. 

For this purpose, a "line of text" means "at! the 
characters waiting to be transmitted, up to and Includ- 
ing the next < EOM-char> or < EOL-string> ." As the 
terminal Is shipped from the factory, its only < EOM- 
char> is (CR), and the < EOL-strlng> consists of one 
character, (CR). Thus, if the terminal is set as it is when 
shipped from the factory, then a "line of text" means 
"all characters to be transmitted, up to and Including 
the next (CR) character." 



If there are no characters waiting in the transmit buffer, 
then each character the operator types enters the 
transmit buffer and is immediately sent to the host 
computer. (This is true even if the terminal Is in prompt 
mode.) Only if the operator could type faster than the 
terminal's transmit rate would more than one character 
be in the transmit buffer. When the operator presses 
RETURN, a (CR) goes into the transmit buffer and is 
sent to the host. Since (CR) is the usual < EOM-char> , 
this also marks the end of a line of text. The terminal 
then waits a short time before sending the next 
character typed. This transmit delay, howeyer, Is 
usually so short as to be imperceptible to the operator. 
(However, In half duplex mode — described in Section 
11 — the transmit delay does last long enough to give 
the host a chance to seize the communications line and 
send a message to the terminal.) 

< SET-TRANSMIT- DELAY> COMMAND 

The <set-transmit-delay> command has this syntax: 
<set-transmit-delay> = (ESC)(N)(D)<int> 

Here, the < int> parameter specifies the approximate 
number of milliseconds In the transmit delay. The 
operator can also change this setting by means of the 
SETUP mode XMTDELAY command. As shipped from 
the factory, the delay is set to 1 00 milliseconds. 
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HALF DUPLEX AND BLOCK MODE 



This section describes the half duplex and block mode 
data communications protocols, which are available if 
the 41 1 4 has Option 01 installed. 



With Option 01 , the terminal supports three types of 
half duplex communications protocol, which are dis- 
cussed in this section along with full duplex mode. 
Option 01 also provides block mode protocol, which is 
a method of formatting data for transmission to and 
from the host. 



FULL AND HALF DUPLEX DATA COMMUNICATIONS 



<SET-DUPLEX-MODE> COMMAND 

Terminals not equipped with Option 01 are always set 
to use the full duplex communications protocol. If the 
terminal has Option 01 (Half Duplex and Block Mode) 
installed, then you can select the duplex mode with the 
<set-duplex-mode> command: 

< set-dupiex-mode> = (ESC)(0)(D)<int> 

Here the < int> parameter is zero for full duplex mode, 
one for half duplex normal, two for half duplex with 
automatic request to send, or three for half duplex with 
supervisor mode. 

Normally, however, the operator (rather than the host 
computer) selects the duplex mode. To do this, the 
operator uses the SETUP mode command, DUPLEX. 
See the 41 1 4 Operator's Manual for details. 

FULL DUPLEX MODE 

In full duplex mode, the data communications line can 
simultaneously carry data to and from the host 
computer. 

In full duplex mode, the terminal sends break signals 
by sending a "space" for longer than the duration of a 
single ASCII character. That is, the terminal puts a 
positive voltage on the TDATA (transmitted data) line at 
the RS-232 connector for a period of time determined 
by the < set-break-tlme> command. (See Section 10 
for a description of the < set-break-time> command. 
See also the description of that command in the 41 1 
Series Command Reference Manual.) 



If Option 01 is installed, the operator can select full 
duplex mode with the SETUP mode command, DUPLEX 
PULL. There is also an escape-sequence version of 
this command, < set-duplex-mode: 0> , as follows: 

< set-duplex-mode: 0> = (ESC)(0)(D)<int: 0> 
= (ESCMO) (D)(0) 

If Option 01 is not installed, the terminal is always set 
to operate in full duplex mode. 

HALF DUPLEX DATA COMMUNICATION 

Some computer systems use the "half duplex" method 
of data communication, in which the terminal and the 
host computer take turns using the same data com- 
munications channel. Half duplex mode offers faster 
data rates than full duplex. 1 For the faster data rates, 
however, there is a price: it is not possible in a half 
duplex system for the host computer to provide a 
"remote echo" of data which the terminal sends. 

With Option 01 installed, the 41 1 4 supports three 
variations of the half duplex communications protocol: 
half duplex normal, half duplex with automatic request 
to send, and half duplex with supervisor. These proto- 
cols differ primarily in how they "turn the line around." 

Unfortunately, even systems programmers often are not 
aware of the subtle differences between the various 
half duplex protocols. This makes it difficult to get the 
information you need to set the terminal correctly. For 
instance, you might be told that your host computer 
uses "half duplex" protocol, when In fact It uses "tut! 
duplex," but with the terminal required to provide its 
own local echo. 



For aimpl* modem* using frequency-shift -keying over votoe-grade telephone 
Hihm, full duplex modam* typically run at a maximum of 300 btts/aaoond, white 
half duplax modem* run at up to 1 200 btta/eeoond. Higher data ratea ar* 
poMlbta with mora eophtatleated modem* or higher-quality communication* 
Una*; In general, however, the half duplex modem* (till offer higher data rata* 
than comparable full duplex modem*. 
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Half Duplex Normal 

In half duplex normal mode, there is only one 
communications channel. The terminal and the host 
computer take turns using this one communications 
channel. 



Host to Terminal. When the host transmits to the 
terminal, it seizes the communications line. It does this 
by sending the RTS — Request To Send — signal to Its 
modem. This causes the modem to place a carrier tone 
on the telephone line. 

While the host has control of the line, the terminal 
cannot transmit data to the host (The terminal's 
modem detects the carrier tone, and sends a DCD — 
Data Carrier Detect — signal to the terminal. While the 
DCD signal is present, the terminal is inhibited from 
transmitting.) If the terminal has data to send, it stores 
that data in an internal transmit queue, until the host 
finishes its transmission and releases the line. 

Terminal to Host. Suppose the host is not using the 
communications line. Then, as soon as the terminal has 
data to send, the terminal seizes the line. (As soon as 
the operator types the first character of a message, the 
terminal asserts RTS, causing its modem to send a 
carrier tone over the telephone line.) 

The terminal continues to hold the line (continues to 
assert RTS) until it encounters an < EOM-char> or 
< EOL-string> in the data which it sends to the host. 
The < EOM-char> or < EOL-string> marks the end of 
the "line of text." The terminal sends the < EOM-char> 
or < EOL-string> and then pauses for a short time. 
(This is the "transmit delay," described in Section 10.) 

During the transmit delay, the terminal relinquishes 
control of the communications line. (It turns off the RTS 
signal, causing its modem to stop transmitting the data 
carrier tone.) This gives the host computer a chance to 
size the communications line and send data to the 
terminal. 

NOTE 

For half duplex normal mode (or any half duplex 
mode) to work properly, it is important that the 
transmit delay should be set to a sufficiently long 
time for the host to respond and seize the 
communications line. 



If the terminal has more data to send and the transmit 
delay time expires without the host's seizing the line, 
then the terminal seizes the line again (asserts RTS 
again) and sends another sequence of characters to 
the host. As before, the terminal continues to hold the 
line until it reaches the end of the line. (That is, the 
terminal continues to assert RTS until it has transmit- 
ted the < EOM-char> or < EOL-string> marking the 
end of the line of text.) 

For more information on < EOM-char> s and < EOL- 
string>s, see "Lines of Text and the Transmit Delay" in 
Section 1 0. See also the 41 1 Series Command 
Reference Manual for descriptions of < EOM-char> , 

< EOM-indicator> , < EOL-string> , < set-EOM- 
chars> , and < set-EOL-string> . 

Selecting Half Duplex Normal Mode. The operator 
can place the terminal in half duplex normal mode with 
the SETUP mode command, DUPLEX NORMAL. (See 
the 41 14 Operator's Manual for details.) There is also 
an escape sequence version of this command, < set- 
duplex-mode: 1 > , as follows: 

< set-duplex-mode: 1> = (ESC)(0)(D)<int: 1> 

= (ESC)(0)(D)(1) 

Half Duplex with Automatic Request to 
Send 

The half duplex with automatic request to send mode 
differs only slightly from half duplex normal mode. 

In half duplex normal mode, if neither the host nor the 
terminal has any data to send, then neither one seizes 
the communications line. (Neither host nor terminal 
asserts RTS, so neither modem sends a carrier tone 
over the telephone line.) 

Some computers, however, will disconnect from the 
telephone line if there is no carrier tone being sent over 
that line. 

The half duplex with automatic request to send mode is 
provided for use with such host computers. In this 
mode, the terminal seizes the line all the time (asserts 
RTS all the time), except only for the short transmit 
delay time which occurs at the end of each line of text 
sent to the host. If the host does not seize the line 
during that transmit delay, then the terminal will seize 
the line again (assert RTS again). The terminal does 
this whether or not it has any data to send. 
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The operator can place the terminal in half duplex with 
automatic request to send mode by typing the SETUP 
mode command, DUPLEX ARTS. There is also an 
escape sequence command, < set-duplex: 2> , as 
follows: 

< set-duplex: 2> = (ESC)(0)(D)<int:2> 
= (ESC)(0)(D)(2) 

Half Duplex with Supervisor 

in half duplex with supervisor mode there is, besides 
the main data communications channel, a secondary 
slow-speed channel. This secondary channel is called 
the "supervisory channel," and the host computer can 
use it to control line turnaround operations. 

Terminal to Host. When the terminal is transmitting 
data to the host, the host sends a signal on the 
secondary channel. (The host sends an SRTS — 
Secondary Request To Send — signal to its modem; 
this causes the modem to place a "secondary carrier" 
on the telephone line.) The secondary carrier serves to 
notify the 411 4 that the host is listening. 

As with the other half duplex modes, the terminal 
pauses at the end of each line, dropping RTS (Request 
To Send) for the duration of the transmit delay. As with 
the other half duplex modes, this pause is intended to 
give the host a chance to seize the communications 
line and send data back to the terminal. 

Unlike the other half duplex modes, however, the half 
duplex with supervisor mode allows the host to seize 
the communications line at anytime — not just during 
the transmit delay at the end of each line. To seize the 
line, the host stops sending the SRTS (Secondary 
Request To Send) signal. This causes its modem to 
stop transmitting the secondary carrier. When the 
terminal's modem detects this, it turns off the SDCD 
(Secondary Data Carrier Detect) signal at the terminal's 
RS-232 connector. The terminal is then obliged to 
relinquish control of the communications line. The 
terminal may send no more than two characters before 
relinquishing control and turning off Its RTS signal. 



Host to Terminal. When the host transmits data to the 
terminal, it asserts RTS, causing its modem to send a 
data carrier tone to the terminal. The terminal's modem, 
on receiving the carrier, notifies the terminal of this by 
asserting the DCD (Data Carrier Detect) signal at the 
RS-232 connector. The terminal asserts SRTS, causing 
its modem to send the secondary carrier signal to the 
host's modem. This notifies the host that the terminal is 
to receive data. 

The terminal cannot transmit to the host until the host 
relinquishes control of the data communications line. 
That is, it cannot transmit until the host turns off the 
data carrier (stops sending the RTS signal). This would 
normally happen when the host is done transmitting 
data to the terminal. 

While the host is transmitting to the terminal, the 
terminal's operator can, if he wishes, press the BREAK 
key. (He would do this if he wanted to interrupt the 
host.) Pressing BREAK causes the terminal to drop the 
secondary carrier (stop asserting SRTS) for a short 
period of time. (This time can be set by the <set- 
break-time> command.) By ceasing to send the secon- 
dary carrier, the terminal is, in effect, telling the host 
that the terminal would like a chance to use the 
communications line. 

However, the host computer need not honor the 
"break" request. It can just keep transmitting. In half 
duplex supervisor mode, if the host sends a "break" 
(drops the secondary carrier), the terminal must relin- 
quish the line. But If the terminal sends a "break," the 
host need not relinquish the line. 

Selecting Half Duplex With Supervisor Mode. The 

operator can put the terminal in half duplex with 
supervisor mode by typing the SETUP mode command, 
DUPLEX SUPER. There is also an escape-sequence 
version of this command, < set-duplex-mode: 3>, as 
follows: 

< set-duplex-mode: 3> = (ESC)(0)(D)<int: 3> 
= (ESC)(0)(D)(3) 



41 14 HOST PROGRAMMER'S 



(S 



11-3 



OPT. 01 : HALF DUPLEX & BLOCK MODE 



BLOCK MODE 



INTRODUCTION 

The terminal's block mode protocol is provided as part 
of Option 01 . Block mode is a method of formatting 
data when sending it to and from the host. 

Some host operating systems make it difficult for the 
user's program to send or receive the full ASCII 
character set. The block mode protocol lets you send 
and receive messages which use the full ASCII charac- 
ter set (including lowercase characters and control 
characters), even though your host's operating system 
makes it difficult to send and receive certain ASCII 
characters. (Indeed, even full eight-bit binary data 
bytes may be sent to or from the terminal in block 
mode.) This is accomplished by means of a packing 
scheme, in which messages using the full character set 
are packed into character strings using a subset of that 
character set. 

Also, the block mode protocol provides error detection 
and automatic retransmission of bad data blocks. This 
lets you transfer data to and from the terminal, without 
errors, despite occasional noise on the 
communications line. 

Block mode is completely independent of whether or 
not prompt mode is used and of whether the terminal is 
using full duplex or half duplex communications. 

When in block mode, data is packed into blocks and 
transmitted as a unit. The host must send the first 
block. The terminal will send a block only in response 
to the host. 

Each block contains an "even/odd" counter (block 
control byte one, bit one) which is used in an 
"ACK/NAK" protocol. This protocol lets the host and 
terminal inform each other when a block has been 
received incorrectly. (The block received incorrectly is 
then retransmitted.) 



BLOCK FORMAT 

Overall Syntax 

Blocks sent from the host and from the terminal have 
the same overall format. Each block consists of one or 
more lines of data, as follows: 

<block> = [<block-"other-than-last"-line> ..J 
< block-last-line> 

where 

< block-"other-than-last"-line> 
= <block-header> 

< block-packed-data> 

< block-continue-char> 
<EOL-string> 



and 

< block-last-line> 



< block-header> 

< block-packed-data> 

< block-end-char> 

< EOL-string> 



Each line begins with a special < block-header> 
character sequence, which is set by the <set-block- 
headers> command. After the header comes the 
packed data, followed by a special character to mark 
the end of the line. This is the < block-end-char> for 
the last (or only) line of a block, or the < block- 
continue-char> if the line is not the last line of the 
block. After the < block-end-char> comes an end-of- 
line string. For blocks sent from the terminal to the 
host, this is the terminal's current < EOL-string> , as 
set by the most recent < set-EOL-string> command. 
For blocks sent from the host to the terminal, the end- 
of-line-string can be any sequence of characters. 

As the terminal is shipped from the factory, the header 
strings are "HEADRX" for blocks sent from the host to 
the terminal, and "HEADTX" for blocks sent from the 
terminal to the host. The < block-continue-char> s for 
transmission to the host and to the terminal are both 
(&).The <block-end-char>s are both ($). The 
< EOL-string> for transmission to the host is the 
single character, (CR). All these values can be changed 
by commands to the terminal. 
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Blocks Sent From the Host to the Terminal 

Using these default settings, a single-line block from 
the host to the terminal might take the following form: 

(H)(E)(A)(D)(R)(X)< block-packed-data> ($){CR){LF) 

(Here, it is assumed that the host ends each line with 
the character sequence (CRMLF). ) 

Likewise, a three-line block from the host to the 
terminal would take this form: 

vn;ien«nunrvvX/<. paeKea-aaia> v&noriMLi-j 
(H) (E) (A) (D) (R) (X) < packed-data> (&) (CR) (LF) 
(H)(E)(A)(D)(R)(X)< packed-data> ($)(CR)(LF) 

Blocks Sent From the Terminal to the Host 

Assuming that the terminal's < EOL-string> , as set by 
the most recent < set-EOL-string> command, is the 
single (CR) character, then a three-line block from the 
terminal to the host would take this form: 

(H)(E)(A)(D)(T)(X)< packed-data> (&)(CR) 
(H) (E) (A) (D) (T) (X) < packed-data> (&) (CR) 
(H)(E)(A)(D)(T)(X)< packed-data> ($)(CR) 

In these examples, the < block-header> s, < block- 
continue-char>s, and <block-end-char>s all have 
their default settings. These settings can be changed 
on command. The settings for blocks sent to the 
terminal can be different from those for blocks sent 
from the terminal to the host. See the 41 1 Series 
Command Reference Manual for descriptions of the 
< set-block-headers> , < set-block-continue-chars> , 
and < set-block-end-chars> commands. 

ENTERING AND LEAVING BLOCK MODE 



Escape Sequence Command 
(From Host Computer) 



SETUP Mode Command 
(From Operator) 



< set-block-continue-chars> 


BCONTINUECHARS 


< set-block-end-chars> 


BENDCHARS 


< set-b!ock-mastsr-chars> 


8MASTERCHARS 


< set-block-non-xmt-chars> 


BNONXMTCHARS 


< set-block-headers> 


BHEADERS 


< set-block-length > 


BLENGTH 


< set-block-line-length> 


BLINELENGTH 


< set-block-packing> 


BPACKING 


< set-block-timeout> 


BTIMEOUT 



(These settings are remembered by the terminal 
even when it is turned off.) 

2. Next, the terminal is armed for block mode: 

Escape Sequence Command SETUP Mode Command 
< arm-for-biock-mode> BLOCKMODE 

3, Finally, the host sends a block to the terminal. The 
terminal enters block mode on receiving the head- 
er characters that begin the first line of that block. 

Exiting Block Mode 

From the Host. The host removes the terminal from 
block mode by sending it a special block containing an 
"exit protocol" command in that block's block control 
bytes. (The block control bytes are described later in 
this section. The "exit protocol" command consists of 
sending < block-control-byte-1 > with its Bit 2 set to 
one rather than zero.) 

From the Keyboard. The operator can remove the 
terminal from block mode with the SETUP mode 
command, BLOCKMODE NO. 



Entering Block Mode 

The procedure for putting the terminal in block mode is 
as follows: 

1 . First, the host computer or the terminal's operator 
issues commands to set the various block mode 
parameters. (These commands must be sent before 
the terminal is armed for block mode.) 



MAXIMUM LINE LENGTH 

There is no maximum line length for blocks sent from 
the host to the terminal. If you like, you can have the 
host send each block to the terminal as one long line. 
On the other hand, if you find it convenient to break the 
block into several lines, you can do that, too. 
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There is, however, a maximum length for lines which 
the terminal sends to the host. This value is set with the 
<set-block-line-length> command. (As shipped from 
the factory, the terminal is set for a maximum line 
length of 70 characters.) For this purpose, the length of 
a line in a block is the number of characters in the 
header string, plus the number of characters of packed 
data on that line, plus one for the < block-end-char> 
or < block-continue-char> . The < EOL-string> is not 
included in this count. 

For instance, suppose that the host computer can 
reliably accept up to 80 characters of data on each 
line, not counting (CR)s as "characters of data." In that 
case, you can set the terminal's maximum block line 
length to 80. To do this, issue a < set-block-line- 
length> command as follows: 

< set-block-line-length: 80> 
= (ESC)(O)(SXint:80> 
= (ESC)(O)(S)(E)(0) 

PACKING DATA INTO A BLOCK 

Packed and Unpacked Data 

The "unpacked data" for a block includes the charac- 
ters of the message (if any) being sent in the block, 
plus four more characters, the block control bytes: 



< unpacked-data> 



< characters-of-message> 

< block-control-bytes> 



The block control bytes are described later in this 
section. They are also described, under "< Block- 
Control-Bytes> ," in Section 4 of the 41 1 Series 
Command Reference Manual. 

In packing the data into the block, the < unpacked- 
data> character sequence is transformed into another 
character sequence which uses a restricted subset of 
the ASCII character set. This character sequence is the 
"packed data." The transformation from unpacked data 
to packed data is done according to a particular 
packing algorithm: 



< packed-data> 



a sequence of ASCII characters 
which is produced by applying 
the packing algorithm to the 
< unpacked-data> character 
sequence 



Maximum Block Length 

The terminal has a "maximum block length" for the 

< unpacked-data> in blocks sent from the terminal to 
the host, and a another maximum block length for the 

< un packed -data > in blocks sent from the host to the 
terminal. When the terminal is shipped from the factory, 
both these maximums are set to 256 characters. These 
values can be changed with the < set-block-length > 
command; see the 41 1 Series Command Reference 
Manual for details. 

Assume that the maximum block length is 256 charac- 
ters. If the terminal is in block mode, and the operator 
types 500 characters before pressing RETURN, then 
the terminal splits that 500-character message into two 
blocks. The first block's < unpacked-data> consists of 
the first 252 characters that the operator typed, plus 
the four block control bytes. The second block holds 
the remaining 248 of the 500 characters, plus the (CR) 
character typed by pressing RETURN, plus four block 
control bytes: a total of 253 characters of < unpacked- 
data> . 

Likewise, if the host has a message of more than 252 
characters to send the terminal, it must split that 
message into more than one block. The first block sent 
to the terminal would have, in its < unpacked-data> , 
the first 252 characters of the message, plus four block 
control bytes for that block. The remainder of the 
message would go into the < unpacked-data> for 
subsequent blocks. 

< EOM-Char> s and < EOM-lndlcator > s 

When the terminal is sending data to the host, it groups 
the data into "messages." Each message text ends with 
an < EOM-char> (end-of-message character) or 
<EOM-indicator> (end-of-message indicator). 



<EOM-Char>s. Typically, the <EOM-char> is (CR). 
Thus, each time the operator presses RETURN, he 
terminates one "message." If the terminal is in block 
mode, the (CR) is packed into the block and causes the 
terminal to end that block. 
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<EOM-lndicator>s. If the data being sent to the host 
is a report message, then there are one or more 

< EOM-indicator> s in the syntax for that report. (The 
syntax for each report message type is given in the 
41 10 Series Command Reference Manual.) Every re- 
port has an < EOM-indicator> at its end. In addition, 
some reports may have optional <EOM-indicator>s 
embedded within their syntax to split the report into 
several "lines of text." Examples are the < GIN-report- 
sequence> , < segment-status-report> , and < error- 
report message types. 

In block mode, when the terminal encounters an 

< EOM-indicator> in a message being sent to the host, 
it terminates the current block and sets an "end-of- 
message" bit in one of the block control bytes. 

The effect of < EOM-indicator> s is similar to that of 

< EOM-char> s. Both < EOM-indicator> s and < ECM- 
char> s cause the terminal to end the current block 
and set the end-of-message bit in the biock control 
bytes. However, < EOM-char>s are packed into the 
block, while < EOM-indicator> s are not. 

Non- Transmittable Characters 

Certain "non-transmittable characters" are not allowed 
to occur within packed data. For instance, the < block- 
end-char> and < block-continue-char> may not oc- 
cur in the packed data, for they signal the end of lines 
in the block. 

When < unpacked-data> is packed into the block, any 
non-transmittable characters occuring in the 

< packed-data> are replaced with two-character se- 
quences. The first character is the < block-master- 
char> , while the second is an uppercase letter. 

To tell the terminal which characters are non-transmit- 
table, you issue a <set-block-non-xmt-chars> com- 
mand: 

< set-block-non-xmt-chars> 

= (ESC)(0)(N)< int-array> < int-array> 

The first < int-array> holds the numeric equivalents of 
the non-transmittable characters for blocks sent from 
the host to the terminal. Likewise, the second < int- 
array> holds numeric equivalents for the host-to- 
terminal non-transmittable characters. During block 
transmission, the first character specified in each 

< int-array> is replaced with < block-master- 
char> (A); the second character is replaced with 

< block-master-char> (B); and so on. 



If the < block-continue-char> , < block-end-char> , or 

< block-master-char> could otherwise occur in < un- 
packed-data> , then they must be included in the set of 
non-transmittable characters. 

When the terminal is shipped from the host, its non- 
transmittable characters are set to (#), ($), and (&), in 
that order. This is because (#) is the default < block- 
master-char> , ($) is the default < block-end-char> , 
and (&) is the default < block-continue-char> . Thus, 
any (#) character which otherwise would occur in the 

< un packed-data > is replaced with (#)(A); any ($) 
occurring in the < unpacked-data> is repiaced with 
(#)(B); and any (&) is replaced with (#)(C). 

Packing Algorithm 

The packing algorithm is as follows. 

Step One. Examine the number of bits per unpacked 
data byte, and the number of bits per packed "pseudo- 
byte," as set by the <set-block-packing> command. If 
they are equal, proceed to Step Four. If they are 
unequal, proceed to Step Two. 

Step Two. The block's < unpacked-data> is regarded 
as a sequence of 7-bit or 8-bit bytes laid "end to end," 
forming one long stream of binary bits. The first bit is 
the high-order bit of the first byte; the last bit is the 
low-order bit of the last byte. 

The <set-block-packing> command determines 
whether the < unpacked-data> consists of 7-bit or 8- 
bit bytes. (The factory default setting is "7-bit bytes," 
since ASCII characters have seven data bits J For 
details, see the < set-block-packing> description in 
the 41 1 Series Command Reference Manual. 

Step Three. Next, the bit stream is divided Into a series 
of "pseudo-bytes" of six, seven, or eight bits each. An 
offset is added to each pseudo-byte, thereby 
converting it into a standard ASCII character. Again, it 
is the < set-block-packing> command which 
determines whether each pseudo-byte consists of six, 
seven, or eight bits. 
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Table 1 1 -1 shows the offset which is added for each 
allowable pseudo-byte size. 

Table 11-1 
PACKED PSEUDO-BYTE CHARACTERISTICS 



No. of 
Meaningful 
Data Bits per 
Pseudo-Byte 


Offset Added 
To Make a 
Standard ASCII 
Character 


Range of 
Possible Decimal 
Equivalents for 
ASCII Characters 
To Be 
Transmitted 


6 


32 


32 to 95 

ASCII characters 
from (SP) to (_) 


7 





to 1 27 

Full ASCII 
character set 


8 





to 255 

Full eight-bit data 
bytes 



If there are not enough bits to fill out the last pseudo- 
byte, an appropriate number of zeroes are appended to 
the end of the bit stream. On input, these extra zeroes 
are ignored. The extra zeroes are inserted only at the 
end of a block — not at the end of lines (other than the 
last line) within the block. 

Step Four. If any of the resulting characters are among 
the non-transmittable characters, they are replaced 
with two-character sequences, starting with the 
"master character." The first non-transmittable 
character specified in the <set-block-non-xmt-chars> 
command is replaced, wherever it occurs, with the 
master character followed by the letter A; the second 
non-transmittable character is replaced by <master- 
char>(B); and so on. 



An Example 

Suppose the following: 

• The terminal is in block mode, and the block mode 
parameters are at their factory settings. That is, the 

< block-continue-char> , < block-end-char> , and 

< block-master-char> are (&), ($), and (#), respec- 
tively; the non-transmittable characters are (#), ($), 
and (&), in that order; the terminal-to-host and host- 
to-terminal header strings are "HEADRX" and 
"HEADTX," respectively; (CR) is the < EOM-char> ; 
the <EOL-string> is the single character, (CR); and 
the unpacked and packed bits-per-byte settings are 
seven and six, respectively. 



• The host has just sent an odd-numbered block to 
the terminal, with the end-of-message bit set. 

• The terminal's operator types "BEGIN_PROGRAM" 
and presses RETURN. 

Then the packing proceeds as follows: 



1. 



Xhfi chsrsctsrs 

(B)(E)(G)(l)(N)(_)(P)(R)(0)(G)(R)(A)(M)(CR),plus 
four < block-control-bytes> , comprise the < un- 
packed-data> for a block. The (CR) — typed by 
pressing RETURN — is an < EOM-char> ; as such, 
it signals the terminal to compute the block control 
bytes, pack them into the current block, and send 
that block to the host. 

The < unpacked-data> consists of the text "BE- 
GIN_PROGRAM", the (CR) character, and the four 
control bytes, as follows: 



character: 
binary: 

character: 
binary: 

character: 
binary: 

character: 
binary: 

character: 
binary: 

character: 
binary: 



(B) 



(E) 



1000010 1000101 



(I) 
1001001 

(P) 



(N) 



(G) 
1000111 

(_) 



1001110 1011111 



(R) 



(0) 



1010000 1010010 1001111 



(G) (R) 
1000111 

(M) (CR) 

1001101 0001101 

(NUL) (BEL) 

0000000 0000111 



(A) 
1010010 1000001 

(A) 
1000001 

(F) 
1000110 



(The last four characters - (A) (NUL) (BEL) (F) - 
are the < block-control-bytes> . They are de- 
scribed later in this section, and in the 41 1 Series 
Command Reference Manual.) 

3. The terminal regroups the stream of binary bits into 
six-bit pseudo-bytes, as follows: 



decimal: 


(33) 


(17) 


(24) 


(60) 


binary: 


100001 


010001 


011000 


1 1 1 1 00 


decimal: 


(38) 


(29) 


(31) 


(40) 


binary: 


101000 


100110 


011101 


011111 


decimal: 


(20) 


(41) 


(60) 


(30) 


binary: 


010100 


101001 


111100 


011110 


decimal: 


(37) 


(1) 


(38) 


(35) 


binary: 


100101 


000001 


100110 


100011 


decimal: 


(24) 


(8) 


(0) 


(15) 


binary: 


011000 


001000 


000000 


001 1 1 1 


decimal: 


(6) 








binary: 


000110 
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Since the unpacked pseudo-byte size is six, Table 
1 1 -1 calls for an offset of 32 (binary 1 00000) to be 
added to each pseudo-byte. This converts each 
pseudo-byte to an ASCII character in the range 
from (SP) to (_): 

(49) (56) (92) 

0110001 0111000 1011100 

(1) (8) CO 



decimal: (65) 
binary: 1 000001 
character: (A) 



decimal: (70) (61) (63) (72) 

binary: 1000110 0111101 0111111 1001000 
character: (F) (=) (?) (H) 

decimal: (52) (73) (92) (62) 

binary: 0110100 1001001 1011100 0111110 
character: (4) (I) (\) (>) 

decimal: (69) (33) (70) (67) 

binary: 1000101 0100001 0100110 1000011 
character: (E) (i) (F) (C) 

decimal: (56) (40) (32) (47) 

binary: 0111000 0101000 0100000 0101111 

character: (8) ("(") (SP) (/) 

decimal: (38) 
binary: 0100110 
character: (&) 

5. The < block-continue-char> , (&), occurs at the 
end of this sequence. Since it is the third non- 
transmittable character, it is replaced by <block- 
master-char> (C), or (#)(C). This gives the follow- 
ing sequence of characters holding the packed 
data: 

<packed-data> = (A)(1)(8)C\)(F)(=K?)(H)(4)(I)C\) 
(>)(E)(!)(F)(C)(8)("(") 
(SP)(/)(#)(C) 

6. The terminal composes and sends a one-line block 
using this < packed-data> : 

<block> = < block-header> 

< packed-data> 

< block-end-char> 
<EOL-string. 

= (H)(E)(A)(D)(T)(X) 

(A)(1H8)C\)(F)(=)(?HH)(4)(I)C0 
(>)(E)(I)(F)(C)(8)("(")(SP)(/)(#)(C) 

(/) 
(CR) 



(Actually, the block is composed and transmitted 
"on the fly" — character by character — as the 
operator types the data on the keyboard. When the 
operator presses RETURN, the (CR) and block 
control bytes are packed and sent. Then the final 
characters of the block are sent: the < block-end- 
char> and <EOL-string>.) 

THE BLOCK CONTROL BYTES 

In block mode, when the terminal or host composes a 
block to be sent over the data communications line, it 
appends four "block control bytes" to the characters or 
other data being packed into the block: 

< unpacked-data> = < characters-of-message> 

< block-control-bytes> 

< block-control-bytes> = < control-byte-1 > 

< control-byte-2> 
<contro!-byte-3> 
<control-byte-4> 

The four control bytes are packed into the block along 
with the other unpacked data, if the "unpacked byte 
size" (as set by the <set-block-packing> command) 
is seven, then each control byte consists of seven 
binary bits. If the unpacked byte size is eight, then 
each control byte consists of eight binary bits. 

Every block contains at least the four block control 
bytes, even if it contains no other characters of 

< unpacked-data> . 

<Contro!-Byto-1 > 

Let Bit 1 be the least-significant bit of the byte; then Bit 
7 or Bit 8 is the most-significant bit of the byte. (Bit 7 is 
the most-significant bit if the "unpacked byte size" is 
seven, since in that case there is no Bit 8.) The 
individual bits are assigned as follows: 

• Bits 1 and 2: Block count and end-protocol. 

• Bit 3, 4, 5: Reserved (always zero) 

• Bit 6: End of file 

• Bit 7: End of message 

• Bit 8: Unused (not present in 7-bit bytes; 

always zero in 8-bit bytes) 
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Bits 1 and 2. In <control-byte-1 >, Bits 1 and 2 
together serve two functions: they determine whether 
the terminal is to exit block mode, and — while the 
terminal is in block mode — they maintain an 
"odd/even" modulo two counter of blocks sent over the 
data communications line. Table 11-2 lists the four 
possible states of these bits, together with their 
meanings. 



End-of-Fiie Bit. Bit 6, the end-of-file bit, is set to one 
at the end of a file transfer; setting this bit serves the 
same purpose as the "end-of-file string" used when the 
terminal is not in block mode. 

End-of-Message Bit. In blocks which the terminal 
sends to the host, Bit 7, the end-of-message bit, when 
set to one, indicates that the terminal has terminated 
the block because it encountered an < EOM-char> or 
< EOM-indicator> in the data being sent. When set to 
zero, this bit indicates that the block was terminated 
only because the maximum block length was reached, 
and that another block follows which contains more of 
the same message. 

In blocks sent from the host to the terminal, Bit 7 has a 
different meaning. If the bit is zero, the terminal is 
requested to acknowledge the block immediately (by 
sending an ACK block in reply). The terminal sends the 
ACK block immediately, whether or not it has a 
message to pack into that block. (The ACK block 
contains only the four block control bytes.) 



If, however, the host sets Bit 7 to one, then the terminal 
does not acknowledge the block immediately. Instead, 
it waits until it has a block full of data to send, or until it 
encounters an < EOM-char> or < EOM-indicator> in 
the data it has to send to the host. 

When sending a block to the terminal, the host should 
set Bit 7 to zero, except when it expects a response 
message from the terminal. If a response message is 
expected, the host should set Bit 7 to one. 



<Control-Byte-2> 

All the bits of <control-byte-2> are reserved; they are 
always zero. 



<Control-Byte-3> and 
<Control-Byte-4> 

The last two control bytes carry a "check code" by 
which the receiving device (the terminal or the host 
computer) can verify that it has received the block with 
no errors. The check code is derived from all the 
unpacked data bytes which precede it: all the 7- or 8- 
bit bytes of meaningful data, plus the first two control 
bytes. The process is as follows: 

1 . Two "checksum bytes" - called H and L for this 
explanation - are both set equal to MaxByte. Here, 
MaxByte is 1 27 (for 7-bit bytes) or 255 (for 8-bit 
bytes). 



Bit 2 



Bit 1 



Table 11-2 
MEANINGS OF LOW-ORDER BITS IN < CONTROL- BYTE- 1 > 



Meaning 



This is an "even" block, and no attempt Is being made to remove the terminal from block mode. 



This Is an "odd" block, and no attempt Is being made to remove the terminal from block mode 



In a block sent from the host to the terminal, these two bits comprise a command to the terminal: "Exit 
from block mode, but remain armed for block mode. Before exiting block mode, however, acknowledge this 
command by sending an 'ACK' block to the host." 

In a block sent from the terminal to the host, these two bits mean, "This is an 'ACK' block acknowledging 
receipt of a command to exit block mode. The terminal is now leaving block mode, but will remain armed 
for block mode." 



In a block sent from the host to the terminal, these two bits comprise a command to the terminal: "Exit 
from block mode, but remain armed for block mode. Exit block mode immediately; do not send an 'ACK' 
block to the host." 

In a block sent from the terminal to the host, this combination of bits is not allowed. 
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3. 



4. 



Each byte in the preceding unpacked data is 
regarded as a binary numeral and added to L. The 
sum is computed as with "modulo 7 (or modulo 8) 
end-around-carry." That is, for a 7-bit "unpacked 
byte size," whenever the sum exceeds the maxi- 
mum 7-bit numeral (1 27), the "carry" bit is omitted 
and one is added to the least-significant bit of the 
sum. Likewise, if the unpacked byte size is 8-bits, 
then whenever the sum exceeds 255, the carry bit 
is omitted and one is added to the least-significant 
bit of the sum. 

This process is equivalent to the following algor- 
ithm, in which MaxByte = 1 27 (for 7-bit bytes) or 
255 (for 8-bit bytes): 

BEGIN 

L := L + Byte; 

IF (L > MaxByte) THEN L := L - MaxByte 
END 

As each byte is added to L, the new value of L is 
added to H. The same "end-around-carry" method 
is used: 

BEGIN 

H := H + L; 

IF (H > MaxByte) THEN H := H - MaxByte 
END 

When Steps 2 and 3 have been performed for each 
of the unpacked bytes preceding the check code 
bytes, then the two check code bytes are comput- 
ed as follows: 

BEGIN 

CI := MaxByte - H - L; 

IF(C1 < OTHENC1 := C1 + MaxByte; 

ControlByte3 := C1 ; 

ControlByte4 := H 
END 



Checking a Received Block. When a block is received 
and unpacked, the H and L checksum bytes are 
computed as described previously. As each byte is 
unpacked, the "unpacked byte" is added to L (with 
end-around carry), and L is added to H (with end- 
around carry). This is done on all bytes as they are 
unpacked, including all four control bytes. When the 
< block-end-char> is detected, H and L should both 
equal MaxByte. That is, if the unpacked bytes are 7-bit 
bytes, then H = L = 1 27; if they are 8-bit bytes, H = L 
= 255. If this is not the case, then a data transmission 
error has occurred. (In that case, the terminal or the 
host receiving the block would retransmit the last block 
it had sent.) 

RETRANSMITTING BAD BLOCKS 

ACK Blocks and NAK Blocks 

Recall, from the description of the block control bytes, 
that the least significant bit of < control -byte- 1 > 
serves as a modulo two "odd/even" counter. This 
counter is used to identify a block as an "ACK block" 
or a "NAK block." 

Host to Terminal. When the host sends a block to the 
terminal, the terminal acknowledges correct reception 
of that block by sending an "ACK block" back to the 
host. This is a block with the same block count bit as 
the block which was correctly received. 

If, however, the terminal detects a checksum error in 
the block, then it retransmits to the host the last 
previous block that it sent the host. The retransmitted 
block has a block count bit which is different from that 
in the block just (incorrectly) received. The fact that the 
block count bit is different identifies that block to the 
host as a "NAK block." 



Packing the Control Bytes Into the Block. When all 
four control bytes have been computed, they are 
packed into the block along with any other unpacked 
data bytes; see the description of the < set-block- 
packing> command for details. 



If the host receives a NAK block, it retransmits the 
block it just sent to the terminal. If the host receives an 
ACK block, then the next block it sends will contain 
new data. 

Terminal to Host. Likewise, when the terminal sends a 
block to the host, the host acknowledges correct 

reception of the block by sending an "ACK block" back 
to the terminal. In this case, however, an ACK block is 
defined as a block with the opposite block count bit. 
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If the host, by means of the checksum bytes, detects an 
error in the block, it retransmits to the terminal the 
previous block it had sent the terminal. That 
retransmitted block has a block count bit which is the 
same as the block count bit in the block which the host 
just (incorrectly) received. The fact that the block count 
bit is the same identifies that block to the terminal as a 
"NAK block." 

If the terminal receives a NAK block, it retransmits the 
block it just sent. If, on the other hand, the terminal 
receives an ACK block, then the next block it sends to 
the host can contain new data. 

Normal, Error-Free Transmission 

Figure 1 1 -1 shows normal transmission of data from 
the host to the terminal. If the terminal has been armed 
for block mode, then it enters block mode on receiving 
the header for the first block sent from the host. 



Host's Point of View. From the host's point of view, 
each "block transaction" consists of sending a block of 
data to the terminal and receiving an ACK block in 
return. (Here, an ACK block is a block with the same 
even/odd count as the block just sent.) Figure 1 1 -1 
shows three such transactions. In the first block 
transaction, the host sends an odd-numbered block to 
the terminal and receives an odd-numbered block in 
return. In the second transaction, the host sends an 
even block and receives an even block in return. In the 
third transaction, the host sends an odd block and 
receives an odd block in return. 

Terminal's Point of View. From the terminal's point of 
view, each "block transaction" consists of sending a 
block to the host and receiving an ACK block in return. 
(Here, an ACK block is a block with the opposite 
odd/even count as the block just sent.) From the 
terminal's point of view, Figure 1 1 -1 shows two com- 
plete block transactions, plus a third transaction which 
is not yet complete. 
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HOST 



Block 
Transaction 



1ST BLOCK (ODD) 

Puts Terminal in Block Mode 




Received Correctly -*- 



Slock 
Transaction 



2ND BLOCK (EVEN) 

Serves as ACK Block 




Received Correctly -*- 



Block 
Transaction 



3RD BLOCK (ODD) 

Serves as ACK Block 




Received Correctly -*■ 



TERMINAL 



■*- Received Correctly 



/ 




ACK BLOCK (ODD) 



-*- Received Correctly 



Block 
Transaction 




ACK BLOCK (EVEN) 



■*- Received Correctly 



Block 
Transaction 




ACK BLOCK (ODD) 



Slock 

Transaction 
> (Which Is 
Not Yet 
Complete) 



Figure 11-1. Error-Free Transmission from Host to Terminal. 
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Effect of Occasional Errors 

Figure 1 1 -2, a continuation of Figure 11-1, shows the 
effect of an occasional noise burst on the data 
communications line. When the host sends the fourth 
block to the terminal, noise on the communications line 
causes that block to be received incorrectly by the 
terminal. The terminal detects a checksum error and 
retransmits the previous block. The host interprets that 
block as a NAK block, and retransmits the fourth block. 
This time, the terminal receives the block correctly. 



Effect of Multiple Errors 

Figure 1 1 -3, which continues from Figure 1 1 -2, shows 
the effect of multiple data communications errors. 
Whenever the checksums do not agree, the host and 
terminal keep retransmitting the previous blocks sent. 
Provided the noise on the data communications line is 
not continuous, eventually the data will be successfully 
transferred. 



HOST 



Block 
Transaction K 



3RD BLOCK (ODD) 




Received Correctly -*- 



4TH BLOCK (EVEN) 

Serves as ACK Block 




TERMINAL 



-»►■ Received Correctly 




ACK BLOCK (ODD) 



.\l/, 
NOISE 



Checksum Error 



l Block 

i Transaction 



Block 
Transaction \ 



Received Correctly 
(But Isn't an ACK) "*" 



<NAK BLOCK (ODD) 
Same as Last Block Sent 



4TH BLOCK (EVEN) 

Retransmitted Because a 
NAK was Received 




-*- Received Correctly 



ACK Received Correctly -*- 




ACK BLOCK (EVEN) 



Incomplete 
> Block 
Transaction 



Figure 1 1 -2. Effect of Occasional Errors in Block Mode Transmission. 
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HOST 



ACK Received Correctly ~+- 



TERMINAL 




ACK BLOCK (EVEN) 



Block 
Transaction 



X 



5TH BLOCK (ODD) 




-*- Received Correctly 



Block 

Transaction 



- NOISE " 
Checksum Error " L/ f\ ^ 



•< ACK BLOCK (ODD) 



X 






5TH BLOCK (ODD) 

(Serves as NAK) 




-. \l/x 
- NOISE - 
— '—// \ n Checksum Error 

X 



Checksum Error 



v\l/ • 
NOISE - 




NAK BLOCK (ODD) 

Same as Previous Block 



5TH BLOCK (ODD) 

(Serves as NAK) 



r\ 



■+- Received Correctly 

(Since It's Odd, It's a NAK) 



Received Correctly -*■ 




ACK BLOCK (ODD) 



6TH BLOCK (EVEN) 

(Serves as ACK) 




■*- Received Correctly 



Block 
Transaction 



3675-38 



Figure 1 1 -3. Effect of Multiple Errors In Block Mode Transmission. 
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< Set-Block-Timeout > Command 

After receiving a block from the host, the terminal 
ignores further characters coming from the host until it 
receives the header string that starts a new block. 

But what happens if the header string itself is garbled 
by noise on the line? In that case, the terminal would 
not detect the start of a new block and so could not 
send a NAK block in response to the (garbled) block. 
The system would "hang," with the terminal waiting for 
a block that never comes. 

All is not lost; there is provision for that situation, too. 
The terminal has a "block timeout" feature, which can 
be set with the < set-block-timeout> command. 

Before arming the terminal for block mode, the host 
issues a < set-block-timeout: 10> command, as fol- 
lows: 



< set-block-timeout: 10> = (ESC)(0)(T)<int: 

= (ESCMOKTM:) 



10> 



This sets the block timeout to ten seconds. With this 
setting, if the terminal sends a block to the host and 
does not receive any block back within ten seconds, 
then the terminal interprets the absence of a reply as a 
NAK, and re-transmits the block just sent. 

You can disable the timeout feature with a < set-block- 
timeout: 0> command. If you use the timeout feature, 
you should set the timeout period to a duration which is 
longer than your host's maximum expected response 
time. 

The operator can also issue the <set-block-timeout> 
command, using the SETUP mode command, 
BTIMEOUT. See the 41 1 4 Operator's Manual for 
details. 



PROGRAMMING CONSIDERATIONS 

The following hints should help you when programming 
the host computer for block mode. 

• The first block sent, which puts the terminal in block 
mode, should be an odd-numbered block. (If the 
terminal receives this block with a checksum error, 
the NAK block it sends in reply is even-numbered. 
For the host to interpret the NAK correctly, it should 
be set to interpret even-numbered blocks as NAKs. 
That is the case if the host has just sent an odd- 
numbered block to the terminal.) 

• All block mode parameters should be set before 
issuing the < arm-for-block-mode> command. (The 
commands to set these parameters are invalid if the 
terminal is armed for block mode.) 

• When the host expects the operator to type on the 
keyboard (or the terminal to send a report message), 
it should send a block to the terminal with the end- 
of-message bit set to one. When the host is sending 
commands to the terminal and does not expect a 
reply (other than ACK blocks), it should set the end- 
of-message bit to zero in blocks sent to the terminal. 

If the terminal receives a block in which the end-of- 
message bit is zero, it acknowledges that block 
immediately: it sends an ACK block which contains 
only the four block control bytes. If, however, the 
end-of-message bit is one, then the terminal does 
not immediately acknowledge the block. Instead, it 
waits until it has data (besides the block control 
bytes) to pack into the ACK block. 
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PERIPHERAL DATA TRANSFERS 



INTRODUCTION 



This section describes data transfers between the 
terminal, the host computer, and optional peripheral 
devices such as a flexible disk drive or a plotter. The 
following major topics are included: 

• Overview of Commands. This introduces the abbre- 
viations for the different peripheral devices, and 
shows how these abbreviations are used in one data 
transfer command, the <copy> command. The 
commands described later in the section are then 
listed, with brief descriptions of each command. 

• Using the Disk Drives. The commands associated 
with Option 42 (single disk drive) and Option 43 
(two disk drives) are given here, with examples of 
their use. 



• Initializing the RS-232 Peripheral Ports. This 
introduces commands to set parameters for the 
Option 10 Three Port Peripheral Interface. 

• Using a Printer. This gives examples of commands 
to configure an RS-232 peripheral port for use with 
an external printer, and of commands to print 
information on that printer. 

• Using a Plotter. This gives examples of commands 
to configure a peripheral port for use with a 
TEKTRONIX 4662 or 4663 Interactive Digital Plotter, 
and of commands to send graphic information to that 
plotter. 

• Using Other RS-232 Devices. 



OVERVIEW OF COMMANDS 



COMMAND FORMAT 

The terminal's data transfer commands can be typed 
by the operator in SETUP mode or sent io the terminal 
as escape sequences from the host. The escape- 
sequence versions of the commands closely resemble 
the SETUP mode versions. 

For instance, consider the COPY command. In SETUP 
mode, the operator can type the following command: 

COPY HO: TO F0:FILE1 



This causes the terminal to copy data coming from the 
host computer ("HO:") to a file named FILE1 on disk 
drive zero ("F0:FILE1"). 

Note that there are three parameters in this COPY 
command. The first parameter ("HO:") denotes the 
source of the data. The second parameter ("TO") is 
included to remind the operator of the direction of data 
transfer. The third parameter ("F0:FILE1 ") names the 
destination for the data transfer. 
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The corresponding escape-sequence < copy> com- 
mand has this syntax: 

<copy> = (ESC)(J)(C) 

< string: source-specifier> 
< string: empty-string or "TO"> 
< string: destination-specifier> 

Note that there are three parameters, ail of type 

< string> , corresponding to the three parameters in 
the SETUP mode COPY command. The second param- 
eter may be the empty < string> , or it may be the 
<string> holding only the letters T and 0. 

Since the host computer must issue commands to the 
terminal as escape sequences, it would send the 
"COPY HO: TO F0:FILE1 .DAT" command as follows: 

< copy: from host to F0:FILE1 .DAT> 

= (ESCMJKC) 

< string: "H0:"> 

< string: empty-string> 

< string: "F0:FILE1.DAT"> 

= (ESCMJKC) 
(3)(H)(0)(:) 
(0) 
(<)(F)(0){:)(FMI)(L)(E)(1)(.)(D)(A)(T) 

= (ESC) (J) (C) (3) (H) (0) (:) (0) (< ) (F) (0) (:) 
(F)(I)(L)(E)(1)(.)(D)(A)(T) . 



DEVICE SPECIFIERS 

In data transfer commands, the source and destination 
devices are represented with three-character device 
specifiers. Examples of these are "HO:" and "FO:", 
used in the preceding example to represent "the host 
computer" and "flexible disk drive number zero." Table 
1 2-1 lists the valid device specifiers. 



Table 12-1 
DEVICE SPECIFIERS 



Device Specifier 


Meaning 


HO: 




The host computer. 


FO: F1 : 




Disk drives zero and one. (Requires 
Option 42 or 43.) 


PO: P1 : 


P2: 


RS-232 peripheral ports. (Requires 
Option 10.) 



12-2 



<a, OCT 1981 



41 14 HOST PROGRAMMER'S 



PERIPHERAL DATA TRANSFERS 



FILE NAMES 

If the source or destination for a data transfer is a disk 
file, that file is represented by a <string> parameter 
such as "FO:FILENAME", "F1 :FILENAME", or just 
"FILENAME". Here, "FO:" or "F1 :" is the device specifi- 
er for the disk drive. "FILENAME" is the name of the file 
on that drive; it is a sequence of up to nine letters, 
digits, and periods (decimal points). The terminal does 
not distinguish between uppercase and lowercase 
letters; "f0:file1 " refers to the same disk file as "FO: 
FILE1 ". If the disk drive specifier ("FO:" or "F1 :") is 
omitted, disk drive zero is assumed.. That is, 
"FILE2.DAT" refers to the same file as "F0:FILE2.DAT". 

DATA-TRANSFER COMMANDS 

Table 1 2-2 lists the data-transfer commands. Thsss 
commands are described later in this section. For more 
detailed Information, see the command descriptions In 
the 41 1 Series Command Reference Manual. 



Table 12-2 
DATA-TRANSFER COMMANDS 



Command Name 



< Copy> 



< Spool > 



< Port-Copy> 



< Save> 



< Load> 



<Directory> 



< Plot> 



Description 



Copies data from a "source" to a "desti- 
nation." 



Similar to < copy> , but the terminal can 
be used for other functions while the 
< spool > operation proceeds. 



Establishes a bidirectional data path to 
a peripheral port. 



Encodes a macro definition or a graphic 
segment as a series of escape-se- 
quence commands, and sends those 
commands to the destination device. 



Takes commands from the specified 
source device and executes them. For 
instance, after a segment has beer, 
<save>d to a disk file, it can be re- 
created by < load> ing that disk file. 



Compiles a directory of the files on a 
diskette and sends that directory to the 
specified destination. If no destination is 
specified, the directory is displayed for 
the operator to see. 



<Save>s all visible segments, sending 
the segment definitions, as escape-se- 
quence commands, to the specified 
destination. 

If the destination is an RS-232 peripher- 
al port to which a TEKTRONIX 4662 or 
4663 plotter is attached, and a < port- 
assign> command has assigned the 
appropriate plotter device driver to that 
port, then the < plot> command causes 
all visible segments to be drawn on the 
plotter. 



41 1 4 HOST PROGRAMMER'S 



P.OCT 1981 



12-3 



PERIPHERAL DATA TRANSFERS 



FORMATTING AND PARAMETER-SETTING 
COMMANDS 

Table 1 2-3 lists commands which prepare the terminal 
(or, in the case of the <format-volume> command, the 
flexible diskette) for subsequent data-transfer com- 
mands. 



Table 1 2-3 

FORMATTING AND PARAMETER-SETTING 
COMMANDS 



COMMANDS TO REPORT PERIPHERAL 
STATUS 

Table 1 2-4 lists commands by which the host compu- 
ter can obtain status information about peripheral 
devices. 



Table 1 2-4 
COMMANDS TO REPORT PERIPHERAL STATUS 



Command Name 


Description 


< Format-Volume> 


Writes formatting information 
on a flexible diskette to pre- 
pare the diskette to hold data 
files. 


< Port-Assign> 


Assigns a "device-driver 
protocol" to an RS-232 peri- 
pheral port. It is by the < port- 
assign> command that you 
inform the terminal what kind 
of device is attached to the 
specified port. 


< Set-Port-Baud-Rate> 

< Set-Port-EOF-String> 

< Set-Port-Flagging-Mode> 

< Set-Port-Parity> 

< Set-Port-Stop-Bits> 

< Set-Port-EOL-String> 


These commands set baud 
rate, parity, and other settings 
for RS-232 peripheral ports. 



Command Name 


Description 


< Report-Device-Status> 


Causes the terminal to send a 
< devlce-status-report> to the 
host computer. The report con- 
tains a status integer in which is 
encoded such information as: 
whether the device is present, 
whether the device is busy, etc. 


< Report-Port-Status> 


Causes the terminal to compose a 
< port-status-report> for the 
specified peripheral port, and to 
send that < port-status-report> 
to the host computer. The report 
message contains information on 
such settings as baud rate, parity, 
stop bits, etc. 
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USING THE DISK DRIVES (OPTIONS 42 AND 43) 



Option 42 includes a single disk drive, while Option 43 
includes two disk drives. These options provide local 
mass storage of graphic segments, macro definitions, 
and other sequences of commands to the terminal. 

<FORMAT-VOLUME> COMMAND 

Before a diskette can store data, it must be formatted. 
Normal!" this is done by the operator, using the SETUP 
mode FORMAT command; see the 41 14 Operator's 
Manual for details. However, this can also be done from 
the host computer, using the escape-sequence com- 
mand, <format-volume> : 

<format-volume>= (ESCMJMF) 

< string: voiumB-specifier> 

< int: number-of-files> . 

The volume-specifier contains a volume name which 
will be displayed in response to <directory> com- 
mands for that diskette; e.g., "VOLUME1 ." This name 
may contain up to nine letters and digits. If you wish, 
you can precede the volume name with the characters 
"FO:" or "F1 :", which stand for "flexible disk drive 
number zero," or "flexible disk drive number one," 
respectively: "F0:VOLUME1 " or "F1 :VOLUME1 ". If you 
omit these characters, the terminal assumes that you 
mean drive zero, the right-hand disk drive. 

The < int> parameter specifies the number of files 
permitted in the diskette being formatted. The number 
actually formatted is a multiple of sixteen; the smallest 
multiple of sixteen which is at least as large as the 
number specified in this parameter. 

Of course, the diskette must not be protected with a 
write-protect switch or write-protect notch. (See the 
41 1 4 Operator's Manual for details.) 



<COPY> FROM HOST TO DISK FILE 

A host program can use the < copy> command to 
create a data file on a diskette in the terminal's disk 
drive. The process is as follows: 

1 . Issue a < copy> command to the terminal. The 
first parameter in this command is < string: 
"HO:"> , specifying the host as the source of the 
data to be transferred. The second parameter is the 
empty string or < string: "TO"> . The third parame- 
ter is a <string> specifying the file to which the 
data is to be copied. For example: 

< copy: "HO:", empty-string, "F0:DATA"> 

= (ESC)(J)(C) 

< string: "HO:"> 

< string: empty-str!ng> 

< string: "F0:DATA"> 

= (ESC)(J)(C)(3)(H)(O)(:)(0)(7)(F)(0) 
(:)(D)(A)(T)(A) . 

2. Send to the terminal the data which is to be 
included in the file. (This could, for instance, 
consist of escape-sequence commands which are 
later to be < load> ed from the disk file.) 

3. Send to the terminal the current < EOF-string> , as 
set by the most recent <set-EOF-string> 
command. This is a sequence of up to ten charac- 
ters which signals the end of the data transfer. 
(The < set-EOF-string> command is described 
later in this section. Like all commands, its defini- 
tive description is to be found in the 41 1 Series 
Command Reference manual.) 
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< EOF-String> s and the < Set-EOF- 
String> Command 

When the < copy> command transfers data to or from 
the host, the end of the data transfer is marked with an 

< EOF-string> (end-of-file string). This is a sequence 
of up to ten ASCII characters, set by the <set-EOF- 
string> command. That command has the following 
syntax: 

<set-EOF-string> 

= (ESCMNME) 

< int-array: ASCII-decimal-equivalents> 

The numbers in the < int-array> parameter are the 
numeric equivalents of the ASCII characters which 
make up the end-of-file string. 

An Example 

You can create a disk file which the operator can later 

< load> into the terminal so as to initialize the terminal 
for a certain task. For instance, the file might contain 
<define-macro> commands to to program certain of 
the terminal's function keys. Or, it might contain 
commands to set the terminal's baud rate, parity, etc., 
for communicating with a certain host computer. To do 
this, send a sequence of commands from the host such 
as the following: 

<set-EOF-string: (47,42,42,47)> 
<copy: "HO:", "TO", "F0:COMMANDS"> 

<define-macro> 

< def ine-macro> 

<define-macro> 



< set-baud-rates> 

< set-parity> 



(/)(*)(*)(/) 

<set-EOF-string: empty-array> 



Here, the first < set-EOF-string> command specifies 
"/"/" as the end-of-file string. (The numbers 47 and 42 
are the decimal equivalents of the characters (/) and 
{*), used in the < EOF-string> .) 

The < copy> command starts the data transfer. The 
host is the source of data, and the file named 
COMMANDS on disk drive zero is the destination. 

The following commands (< define-macro> , < set- 
baud-rates> , etc.) are part of the data being trans- 
ferred. The terminal does not execute these commands, 
but just copies them into the destination file (the file 
named COMMANDS, on disk drive zero). 

The characters (/)(*)(*)(/) are the < EOF-string> ; they 
mark the end of the data transfer. When the terminal 
encounters these characters, it closes the disk file FO: 
COMMANDS and ceases to execute the < copy> 
command. 

The final < set-EOF-string> command sets the < EOF- 
string> to the empty string. This command is as 
follows: 

<set-EOF-string: empty-array> 

= (ESCMNME) 

< int-array: empty> 

= (ESCMNMEMO) . 

You may be wondering why this last command is 
necessary. It is needed because the terminal 
suppresses < EOF-string>s in the data it reads from 
the host. After the file transfer, it is possible that the 
host might have occasion to send the character 
sequence (/)(")(*)(/), perhaps as <xy> coordinates in 
graphic data, or as < int> parameters for some 
command. Should that occur, the terminal would still 
recognize those characters as the current < EOF- 
string> , and would remove them from the data it 
receives. This could cause undesired results. The 
problem can be avoided by (a) choosing an < EOF- 
string> which is unlikely to occur in data sent to the 
terminal, or (b) by setting the < EOF-string> to the 
empty string except when it is needed for a data 
transfer. The latter approach was used in this example. 
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< COPY> FROM DISK FILE TO HOST 

The < EOF-string> plays the same role in a <copy> 
to the host computer as it does in a <copy> from the 
host to the terminal. This time, however, it is the 
terminal which issues the < EOF-string> , and the host 
which must recognize that < EOF-string> as marking 
the end of the data transfer. 

<DIRECTORY> COMMAND 

The < directory> command prepares a disk directory 
for the specified disk drive, and sends that directory to 
a specified destination. (If no destination is specified, 
the directory information is sent to the terminal's 
display.) The escape-sequence command has the 
following syntax: 

<directory>= (ESC)(J)(D) 

< string: disk-drive-specifier> 
< string: empty-string or "TO"> 

< string: destination-specifier> 

The SETUP mode version of this command is described 
in the Operator's Manual. The following examples show 
how it might be used: 



DIRECTORY FO: 



Displays a directory of the files 
on the diskette in disk drive zero. 
(Since the second and third par- 
ameters are omitted, the directo- 
ry is sent to the terminal's dis- 
play: to the dialog area if the 
dialog area is enabled, otherwise 
to the current graphic beam 
position.) 



DIRECTORY FO: TO F0:DIRECTORY 

Composes a directory of the files 
on the diskette in disk drive zero, 
and records that directory in the 
file named DIRECTORY on that 
disk drive. 



DIRF0:TOP1: 



DIR FO: TO HO: 



Composes a directory of the files 
on disk drive zero, and sends 
that directory to RS-232 peri- 
pheral port number one. If a 
printer is attached to that port, 
then the file directory is printed. 
If a plotter is attached to that 
port, then the plotter "prints" the 
file directory. 

Sends to the host computer a 
directory of the files on disk 
drive zero. At the end of the data 
transfer, the terminal sends the 
current < EOF-string> , as set by 
the most recent < set-EOF- 
string> command. 



The host computer can issue <directory> commands 
by using the escape-sequence syntax just described. 
For instance, the host's equivalent of DIR FO: TO PO: 
would be the following: 

< directory: "FO:", empty-string, "P0:"> 

= (ESCKJMD) 

< string: "F0:"> 

< string: empty-string> 

< string: "P0:"> 

= (ESO(JKD) 
(3)(F)(0)(:) 
(0) 
(3)(P)(0)(:) 

= (ESC)(J)(D)(3)(F)(0)(:)(0)(3)(P)(0)(:) . 
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Figure 1 2-1 shows the result of a typical <directory> 
command, as displayed on the terminal's screen. 



-NAME blocks b 


,TES 


PROTECT 




F0:K7KK 


£002 




NO 




KITTY 


9 


b 


NO 




DSTAR 


46 


5 b 


NO 




BUMP 


34 


34 


NO 




DRAGON 


15 


107 


NO 




GRINCH- 


9 


154 


NO 




OS U1 


i' 


- - 
cc 


NO 




LASERGUN 


- 1 1—. 

CO 


109 


NO 




MAZE 


6 


162 


NO 




MAGIC 


c 


18 


NO 




MICKEY 


4 


121 


NO 




PARAB 


4 


147 


NO 




R2D2 




103 


NO 




SNOOPY 


c 


205 


NO 




STAR 


c, 


213 


NO 




SYMBOL 


10 


104 


NO 




UIZARD 


9 


75 


NO 




SEGMENT1 


10 


153 


NO 




PATTERNS 


4 


206 


NO 




PATTERNS2 


10 


-- 1 ^ 

L_ 1 


NO 




-ENTRIES USED: 


19 








-ENTRIES FREE: 


349 








-BLOCKS USED: 


271 








-BLOCKS FREE: 


1731 








-LARGEST FREE: 


1715 






3892-4 



Figure 1 2-1 . < Directory> Command Report Format. 
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< Directory> to a Printer 

If the terminal is equipped with Option 10 (Three Port 
Peripheral Interface), then you can send <directory> 
reports to a printer attached to one of the RS-232 
peripheral ports. For this to work properly, the following 
conditions must be met: 

• The peripheral port must have a "4643" device 
protocol assigned to it. (See the description of the 
< port-assign> command, later in this section.) 

• The peripheral port's end-of-line string must be set 
to (CRKLF). (See the < set-port-EOL-string> com- 
mand description for details.) This is necessary in 
order for the terminal to send (CRMLF), rather than 
just (CR), at the end of each line in the <directory> 
message. 

9 The peripheral port baud rate, parity, etc., must be 
set to match the corresponding values for the printer 
connected to that port. 

Once these conditions are met, the operator and host 
computer can issue a <directory> command with the 
printer port as the specified destination device. For 
instance, if a printer is attached to peripheral port 
number one, the operator might type the following 
SETUP mode command: 

DIRECTORY FO: TO P1 : 

This causes a directory of the files on disk drive zero 
("FO:") to be printed on a printer attached to peripheral 
port number one ("P1 :"). The corresponding escape- 
sequence command from the host computer would be: 

< directory: "FO:", empty-string, "P1 :"> 

= (ESCKJKD) 

< string: "F0:"> 

< string: empty-string> 

< string: "P1:"> 

= (ESC)(J)(D)(3)(F)(0)(:)(0)(3)(P)(1)(:) . 



< Directory> to a Plotter 

If the terminal is equipped with Option 10 (Three Port 
Peripheral Interface), then you can send <directory> 
reports to a TEKTRONIX 4662 or 4663 Interactive 
Digital Plotter. For this to work properly, the following 
conditions must be met: 

• The plotter must be set for "CR implies CR-LF" 
mode. This is because each line of the directory 
report ends with a single (CR) character — not 
(CRKLF). 



Other plotter parameters must be set as follows: 



Attention character 
Address character 



(ESC) 
(A) 



• The peripheral port must have a "4662/NT" or 
"4663/NT" protocol assigned to it. (See the descrip- 
tion of the < port-assign> command, later in this 
section.) The port baud rate, stop bits, etc., must be 
set to agree with the corresponding plotter settings. 

• The operator must position the plotter pen (with the 
joystick) to the upper left corner of the plotter's 
viewport. 

Once the plotter and the peripheral port have been set 
up this way, the operator or the host computer can 
issue a < directory> command and let the plotter draw 
the resulting file directory. For instance, if the plotter is 
at peripheral port zero, the operator types the following 
SETUP mode command: 

DIRECTORY FO: TO PO: 

To produce the same result, the host computer would 
issue the corresponding escape-sequence command: 

< directory: "FO:", empty-string, "P0:"> 

= (ESC)(J)(D) 

< string: "F0:"> 

< string: empty-string> 

< string: "P0:"> 

= (ESC)(J)(D)(3)(F)(0)(:)(0)(3)(P)(0)(:) . 

< Directory> to the Host Computer 

The host can cause the terminal to send it a file 
directory, as follows: 

< directory: "FO:", empty-string, "HO:"> 

= (ESC)(J)(D) 

< string: "F0:"> 

< string: empty-string> 

< string: "HO:"> 

= (ESC)(J)(D)(3)(F)(0)(:)(0)(3)(H)(O)(:) . 

As with the < copy> command, the end of the data 
transfer is marked with an < EOF-string> . (In block 
mode, the end of the data is marked with the end-of- 
message bit in the block control bytes. See Section 1 1 
for details.) 

Each line of the message sent to the host ends with a 
single (CR) character — nor the character sequence 
(CRXLF). 
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<RENAME-FILE> COMMAND 

The < rename-file> command lets you assign a new 
name to a disk file. For instance, in SETUP mode, the 
operator can type: 

RENAME FILE1 TO FILE2 

This takes the file F0:FILE1 (the file named FILE1 on 
disk drive zero) and renames it F0:FILE2. 

The escape-sequence syntax for this command is as 
follows: 

< rename-f ile> = (ESO(JMR) 

< string: old-file-specifier> 

< string, empty-string or "TO "> 

< string: new-file-specifier> 

For more details, see the description of the < rename- 
file> command in the 41 10 Series Command Refer- 
ence Manual. 

< DELETE-FILE> COMMAND 

The <delete-file> command lets you delete a disk file. 
For instance, in SETUP mode, the operator can type: 

DELETE F0:FILE1 

This deletes the file named FILE1 from the diskette in 
disk drive zero. The escape-sequence syntax for this 
command is as follows: 

< delete-file> = (ESC)(J)(K) 

< string: file-specifier> 

For instance, to delete the file F0:ABCDEF, the host 
program can issue the following command: 

<delete-file: "F0:ABCDEF"> 

= (ESC)(J)(K)< string: "F0:ABCDEF"> 

= (ES)(J)(K)(9)(F)(0)(:)(A)(B)(C)(D)(E)(F) . 

For more details, see the description of this command 
in the 41 10 Series Command Reference Manual. 



<LOAD> COMMAND 

The < load> command causes a disk file to be 
executed by the terminal, just as if the commands (or 
other data) in the file were sent to the terminal by the 
host computer. 

Suppose, for instance, that the command file 
FO:INITIALIZ has been created by < copy> ing data 
from the host computer. In the file are escape- 
sequence commands for the terminal. To cause these 
commands to be executed, the operator puts the 
terminal in SETUP mode and types: 

LOAD FO:INITIALIZ 

In response to this command, the terminal reads the 
data in the file, treating that data in the same way as it 
treats data coming from the host computer. The 
terminal executes any escape-sequence commands 
which it finds in the file. 

The escape-sequence version of this command is as 
follows: 

<load>=(ESC)(J)(L) 

< string: file-specifier> 

For more details, see the description of this command 
in the 41 10 Series Command Reference Manual. 
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<SAVE> COMMAND 

The <save> command lets you save macro definitions 
or graphic segments as escape-sequence commands 
in a disk file. Later, the file can be < !oad> ed to restore 
to the terminal the information which was <save>d. 

The operator can type this command in SETUP mode, 
or it may be sent as an escape-sequence command 
from the host computer. The following examples show 
how an operator might use this command: 



SAVE SEQ 1 TO F0:SEGMENT1 

Saves graphic segment number 
one as a series of escape- 
sequence commands on disk 
drive zero, in the file named 
SEGMENT1 . 

SAVE MAC 1 28 TO MACR0.65 

Saves macro definition number 
1 28 (the macro which may be 
invoked with function key F1 ) as 
a series of escape-sequence 
commands in the file named 
MACR0.65 on disk drive zero. 

SAVE SEG -1 TO SEGMENTS 

Saves the definitions of all 
graphic segments in a file named 
SEGMENTS on disk drive zero. 

The escape-sequence syntax for this command is as 
follows: 

<save>=(ESC)(J)(V) 

< string: cod6-ior-thing-io-be-sav6d> 

< int: item-number-or-count> 

< string: empty-string or "TO"> 

< string: destination-specifier> 

< string: code-for-thing-to-be-saved> 
= < string: "SEG"> 
or < string: "MAO . 



For instance, the host computer could define a seg- 
ment, save it on a disk file, and delete the segment 
definition by issuing commands such as the following: 

< delete-segment: 5> 

< begin-segment: 5> 

< enter-vector-mode> 
<xy> 
<xy> 



< enter-vector-mode> 
<xy> 
<xy> 



<end-segment> 

<save: "SEG", 5, "TO", "F0:SEGMENT5"> 

< delete-segment: 5> 

Later, the segment definition can be recalled from the 
disk with a <load> command: 

<load:"F0:SEGMENT5"> 

The < save> command can have other destinations 
than a disk file. For instance, the operator can type the 
following in SETUP mode: 

SAVE SEG 3 TO PO: 

If a plotter is connected at port zero, this command 
would cause segment 3 to be drawn by that plotter. 
(For this to work properly, port zero must have the 
appropriate plotter protocol assigned to it, and the 
plotter itself must be set up properly. These details are 
described later in this section.) 

For other information about the <save> command, see 
the command description in the 41 1 Series Command 
Reference Manual. 
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INITIALIZING THE RS-232 PERIPHERAL PORTS (OPTION 10) 



The Option 10 Three Port Peripheral Interface provides 
three RS-232 peripheral ports to which may be at- 
tached such peripheral devices as a TEKTRONIX 4641 
Printer, or TEKTRONIX 4662 or 4663 Interactive Digital 
Plotters. 

<PORT-ASSIGN> COMMAND 

The < port-assign> command assigns a "device proto- 
col" to a particular RS-232 peripheral port. 

The SETUP mode name for this command is PASSIGN. 
The following examples show how the operator uses 
the PASSIGN command when attaching peripherals to 
the terminal: 



PASSIGN PO: 4662 



PASSIGN PO: PPORT 



PASSIGN P1: 4643 



Assigns a general-purpose RS- 
232 protocol to RS-232 peri- 
pheral port zero. The PPORT 
protocol makes no assumptions 
about the nature of a device 
which may be attached to this 
port. 

Assigns the 4643 protocol to 
peripheral port one. This is 
similar to the PPORT protocol. 
However, any (CR) characters 
occurring in data sent to this port 
will be replaced with the port's 
current end-of-line string, as set 
by the < set-port-EOL-string> 
command. 

If you want to print data (such as 
a <directory> report) in which 
lines end with (CR) rather than 
(CRMLF), set the port's < EOL- 
string> to (CRMLF). (Use the 
<set-port-EOL-string> com- 
mand, described later in this 
section.) That way, each (CR) in 
the file is replaced with (CRMLF), 
and the printer displays each 
line of the file on a new line of 
the output paper. This is espe- 
cially convenient for doing 
<directory> commands with the 
printer as a destination. 

If the data to be printed already 
includes (CRMLF) sequences at 
the end of each line, then you 
would set the port's end-of-line 

string to just (CR). 



Assigns a "4662" device-driver 
protocol to peripheral port zero. 
With this protocol assigned, the 
terminal assumes that a TEK- 
TRONIX 4662 Interactive Digital 
Plotter is connected to the peri- 
pheral port. 

Any data being sent to port zero 
is sent using the 4662's block 
mode communications protocol. 
Carriage returns and line feeds 
are translated into "move" com- 
mands for the plotter, and 41 1 0- 
style escape-sequence 
commands are translated into 
equivalent plotter-language com- 
mands. 1 



PASSIGN PO: 4662/NT Similar to the above; the terminal 
assumes that the device at- 
tached to this port is a 4662 
plotter, and uses the plotter's 
block mode protocol for data 
sent out this port. However, NO 
TRANSLATION of carriage re- 
turns, line feeds, or 41 1 0-series 
escape-sequence commands is 
performed. 1 

PASSIGN PO: 4662/MP Informs the terminal that a 4662 
plotter with the MULTIPLE PEN 
option is connected to port zero. 
As with the "4662" protocol, the 
plotter's block mode is used, and 
41 1 0-series commands are 
translated into corresponding 
commands for the plotter. 



PASSIGN P2: 4663 



Assigns a "4663" protocol to 
peripheral port two. This informs 
the terminal that a TEKTRONIX 
4663 Interactive Digital Plotter is 
connected to the port. 1 

As with the "4662" protocol, the 
plotter's block mode is used. As 
with the "4662" protocol, car- 
riage returns, line feeds, and 
41 1 0-series escape-sequence 
commands are translated into 
corresponding plotter-language 
commands. 1 



8m NOTE undar "Utlng a Plotter.' 
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PASSIGN P2: 4663/NT Similar to "4663" protocol, ex- 
cept that NO TRANSLATION to 
plotter language is performed. 



PASSIGN P2: 4663/NB Similar to "4663" protocol, ex- 
cept that the plotter's block 
mode communications feature is 
not used. 



OTHER COMMANDS FOR INITIALIZING 
PERIPHERAL PORTS 

Besides the < Port-Assign> command, several other 
commands are needed to initialize a peripheral port for 
use with a particular peripheral device. These com- 
mands are: < set-port-baud-rate> , < set-port-EOF- 
string> , < set-port-EOL-string> , < set-port -flagging- 
mode> , < set-port-parity> , and < set-port-stop-bits> . 

All these commands (including <port-assign>) are 
remembered by the terminal even when it is turned off. 
Thus these commands normally need be issued only 
once, when the operator attaches the peripheral device 
to the terminal's peripheral port. 



<Set-Port-EOF-String> Command 

The <set-port-EOF-string> command sets the end-of- 
file string used at a peripheral port. If the peripheral 
port does not have a plotter protocol < port-assign>ed 
to it, then the port's end-of-file string, as set by this 
command, is appended to the end of any data sent to 
that port. Likewise, if the peripheral port is the source 
for a data transfer, the port's end-of-file string serves to 
mark the end of the data transfer in a < copy> , 
< load> , < spool> , or < port-copy> operation. 

The SETUP mode name for <set-port-EOF-string> is 
PEOF. Thus, the operator can type the following 
command in SETUP mode: 

PEOF P1 : "/"/" 

This sets peripheral port one's end-of-file string to the 
following four-character sequence: (/)(*)(*)(/). The es- 
cape-sequence version for this exampie is: 

<set-port-EOF-string: "P1:", (47,42,42,47) > 

= (ESCKPHE) 
< string: "P1:"> 
<int-array: (4 7, 42, 4 2, 47) > 

= (ESC)(P)(E)(3)(P)(1)(:)(4)(B)(?)(B)(:)(B)(:)(B)(?) . 



<Set-Port-Baud-Rate> Command 

The SETUP mode name for the < set-port-baud-rate > 
command is PBAUD. For instance, in SETUP mode, the 
operator can type: 

PBAUD PO: 300 

This sets the transmit and receive baud rates at 
peripheral port zero to 300 bits per second. The 
equivalent escape-sequence command for this is: 

< set-port-baud-rate: "PO:", 300> 

= (ESCKPMB) 
< int: 300> 

= (ESC)(P)(B)<RM)(<) . 
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<Set-Port-EOL-String> Command 

The <set-port-EOL-string> command sets a peripher- 
al port's "end-of-line string." The port end-of-line string 
is used only if the "4643" protocol has been < port- 
assign> ed to that port. If that is the case, every (CR) 
character which otherwise would be sent to the port is 
replaced with the port's end-of-line string. 

For example, suppose you want to print a file directory 
on a printer attached to peripheral port one. The 
<directory> command produces text in which each 
line ends with (CR) — not (CR)(LF). So, you type the 
following commands in SETUP mode: 

PEOLP1: " c r l f" 
PASSIGN P1 : 4643 
DIRECTORY FO: TO P1 : 

Here, the PEOL command is the SETUP mode version 
of < set-port-EOL-string> . It assigns the character 
sequence (CRMLF) as the end-of-line string for peri- 
pheral port one. The PASSIGN command assigns the 
"4643" protocol to that port, so that any (CR)s in the 
data will be replaced with (CR)(LF) sequences. Finally, 
the DIRECTORY command sends a directory of the 
files on disk drive zero the printer attached to 
peripheral port one. 

The escape-sequence version of this PEOL command 
is as follows: 

< set-port-EOL-string: "P1 :", (1 3,1 0)> 

= (ESC)(P)(M) 
< string: "P1:"> 
<int-array: (13,1 0)> 

= (ESC)(P)(M)(3)(P)(1)(:)(2)(=)(:) . 

If the data to be transferred to a peripheral port has 
{CRMLF) sequences at the end of each line, then you 
can set the port's end-of-line string to just (CR). 
Alternatively, the PPORT protocol can be < port- 
assign>ed to the peripheral port. 



<Set-Port-Flagging-Mode> Command 

The <set-port-flagging-mode> command chooses the 
flagging mode used at a peripheral port, just as the 
<set-flagging-mode> command selects the flagging 
mode used for communicating with the host computer. 

In SETUP mode, the name of the command is PFLAG, 
and the keyword options for the first parameter are 
NONE, DTR/CTS, and CHAR. If CHAR (for character 
flagging) is chosen, the operator can enter single 
character third and fourth parameters to indicate the 
"go" and "stop" characters. The following examples 
illustrate this: 

PFLAG PO: NONE Disables flagging at peripheral 

port zero. 

PFLAG P1 : DTR/CTS Enables DTR/CTS flagging at 

peripheral port one. A peripheral 
device at this port indicates that 
it is ready to receive data by 
asserting the DTR (Data Terminal 
Ready) signal at the RS-232 per- 
ipheral port connector. The ter- 
minal indicates when it is ready 
to receive data from a peripheral 
by asserting CTS (Clear To 
Send) at the port connector. 

PFLAG P2: CHAR D - D 3 Enables "character flagging" at 
peripheral port two. A peripheral 
device at this port indicates 
when it is not ready for data by 
sending a (DC3) character to the 
terminal. When it is ready for 
more data, it sends a (DC1 ) to 
the terminal. Likewise, when the 
terminal accepts data from the 
peripheral device, it uses (DC1) 
as a "go" character and (DC3) as 
a "stop" character. 



PFLAG P2: CHAR 



Same as above; if the "go" and 
"stop" characters are omitted 
from the command, (DC1 ) and 
(DC3) are used as defaults. 
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The escape-sequence syntax for the < set-port-f lag- 
ging> command is as follows: 

< set-port-f lagging>= (ESC) (P)(F) 

< string: port-identifier> 
<int: flagging-mode> 
<int: "GO"-character> 
<int: "STOP"-character> 

The port-identifier < string> is either "PO:", "P1 :", or 
"P2:". The flagging-mode < int> is either zero (no 
flagging), one (for character flagging), or two (for 
DTR/CTS flagging). The GO and STOP characters are 
represented by their numeric equivalents (range to 
1 27), sent in the < int> parameters. 

For example, to enable CHAR flagging at peripheral 
port two, with (DC1) as the GO character (ASCII 
decimai equivalent of 1 7), and with (DCS) as ihe STOP 
character (decimal equivalent 19), the host computer 
could send the following escape sequence: 

< set-port-flagging: "P2:", 1 , 1 7, 1 9> 

= (ESCMPKF) 
<string: "P2:"> 
<int: 1> 
<int: 17> 
<int: 19> 

= (ESC)(P)(F)(3)(P)(2)(:)(1)(A)(1)(A)(3) . 



< Set-Port-Parity > and <Set-Port-Stop- 
Bits> Commands 

The < set-port-parity> and < set-port -stop-bits> com- 
mands are described in detail in the 4110 Series 
Command Reference Manual. (The SETUP mode 
names for these commands are PPARITY and PBITS, 
respectively.) The commands set a peripheral port's 
parity and number of stop bits to conform with the 
requirements of a peripheral device attached to that 
port. 

The following examples show how these commands 
might be used in SETUP mode: 



PPARITY PO: NONE 
PBITS 1 8 



PPARITY PO: EVEN 
PBiTS 2 7 



Sets port zero so that characters 
at that port have eight data bits, 
no parity bit, and one stop bit. 

Sets port zero so that characters 
at that port have seven data bits, 
one parity bit using even parity, 
and two stop bits. 



For more details, see the descriptions of the < set-port- 
parity> and <set-port-stop-bits> commands in the 
41 1 Series Command Reference Manual. 
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USING A PRINTER 



INITIALIZING THE PORT 

When the operator attaches a printer to one of the 
terminal's RS-232 peripheral ports, he should also type 
several SETUP mode commands to configure the 
peripheral port for use with that printer. 

4641 Printer. Before connecting a TEKTRONIX 4641 
printer to one of the terminal's RS-232 peripheral ports, 
you should check to be sure that the 4641 is equipped 
with Option 30 (RS-232 Interface). The internal switch- 
es on the 4641 Buffered Seriai interface Card must 
also be set correctly; Table 1 2-5 lists one possible 
switch configuration. 



Table 1 2-5 
4641 INTERFACE CARD SWITCH SETTINGS 



Switch 


Condition 


S1 


OFF 


S2 


ON 


S3 


OFF 


S4 


ON 


S5 


OFF 


S6 


ON 


S7 


ON 


S8 


OFF 



The switch settings in Table 1 2-5 set the 4641 printer 
to operate at 9600 baud, with DTR flagging when the 
printer's buffer is full. 

With the 4641's switches set as in Table 1 2-5, you can 
type the following SETUP mode commands to initialize 
the terminal's peripheral port number one: 



PBAUDP1: 9600 



Sets port one for 9600 baud. If 
the printer is set for a different 
baud rate, then use that baud 
rate in this command. (See 
"Technical Data," in Part One of 
the 4641/4641-1 Operator's 
Manual for details about setting 
the printer's baud rate.) 



PPARITY P1 : HIGH 

PBITS P1 : 1 7 

or 

PPARITY P1 : NONE 

PBITS P1 : 1 8 



PEOLP1:" c r l f" 



The first two commands set port 
one to send ASCII characters 
consisting of seven data bits, a 
parity bit (always one), and one 
stop bit. The second two com- 
mands will also work; they set 
the port for eight data bits, no 
parity bit, and one stop bit. 

Both of these settings assume 
that the 4641 is set for "no 
parity." (See "Jumper Func- 
tions," in Part Two, Section 3 of 
the 4641 Operator's Manual for 
information on setting the 4641 
for "no parity.") 

Sets port one's end-of-line string 
to (CRMLF). This assumes that 
the 4641 's jumper W8 is in- 
stalled, thereby disabling the 
4641 's "CR implies CR-LF" fea- 
ture. (See "Jumper Functions," in 
Part Two, Section 3 of the 4641 
Operator's Manual.) 

Assigns the "4643" protocol to 
peripheral port one. Any (CR) 
characters in text sent to this 
port will be replaced with the 
port's end-of-line string: 
(CRMLF). 



PFLAG P1 : DTR/CTS Sets port one for "DTR/CTS" 
flagging. This is necessary to 
prevent data over-run when 
sending text to a printer at port 
one. 

4642 Printer. The TEKTRONIX 4642 Printer is not 
compatible with Tektronix 41 10-series terminals. 



PASSIGN P1 : 4643 
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<COPY> TO A PRINTER 

Once the printer pert has been initialized, the operator 
or the host computer can issue <copy> commands to 
transfer data to the printer. For example, the operator 
can create a file holding a directory of disk files, and 
then < copy> that file to a printer at port one, as 
follows: 

DIRECTORY FO: TO F0:FILE1 
COPY F0:FILE1 TO P1 : 

< DIRECTORY> TO A PRINTER 

The following SETUP mode command causes a disk 
directory to go directly to a printer port number one: 

DIRECTORY FO: TO P1 : 

<SPOOL> TO A PRINTER 

If you have much data to send to a printer, you may 
wish to use the < spool> command rather than 

< copy> . With the < spool> command, the data trans- 
fer occurs "in the background." That is, the terminal 
can be used for other purposes while it is < spool> ing 
data to a printer. 

For example, the operator might type these two com- 
mands in SETUP mode: 

DIRECTORY FO: TO F0:DIRECTORY 
SPOOL F0:DIRECTORY TO P1 : 

Here, the DIRECTORY command creates a disk file 
named DIRECTORY, and the SPOOL command copies 
that file to a printer attached to port number one. Unlike 
the COPY command, the SPOOL command lets the 
operator use the terminal for other purposes while the 
file is being printed out. 



The escape-sequence version of the < spool> com- 
mand has the following syntax: 

<spool>=(ESC)(J)(S) 

< string: source-specifier> 

< string: empty-string or "TO"> 

< string: destination-specifier> 

For example, the escape-sequence version of the 
SETUP mode command, "SPOOL F0:DIRECTORY TO 
P1 :" would be: 

< spool: "F0:DIRECTORY", empty-string, "P1:"> 

= (ESCKJKS) 

< string: "F0:DIRECTORY"> 

< string: empty-string> 

< string: "P1:"> 

= (ESC) (JMS) « ) (F) (0) (:) (D) (I) (R) (E) (C) 
(T)(O)(R)(Y)(0)(3)(P)(1)(:) . 

To abort a <spool> operation before it is finished, use 
the <stop-spooling> command. (The SETUP mode 
name for this command is STOP.) 

<stop-spooling>=(ESC)(J)(E) . 

For more information on the < spool> and < stop- 
spooling> commands, see their descriptions in the 
41 10 Series Command Reference Manual. 
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USING A PLOTTER 



CONNECTING THE PLOTTER TO THE 

TERMINAL 

When using a TEKTRONIX 4662 or 4663 Interactive 
Digital Plotter, connect the plotter's "modem" connec- 
tor to one of the terminal's three RS-232 peripheral 
ports. 

NOTE 
Do not connect the plotter between the terminal's 

forget r\r>ri or>W +foa t\/*i&+ r+r\mm f+or A fihm trtl*\ #hr* 

plotter is designed to run in this configuration, the 
terminal design assumes that the plotter is con- 
nected to one of the RS-232 peripheral ports. 

INITIALIZING THE PORT 

To use a TEKTRONIX 4662 or 4663 Interactive Digital 
Plotter with the terminal's RS-232 peripheral port, you 
must set the plotter's switches and the peripheral port 
settings in a compatible way. For instance, if the plotter 
is set to operate at 1 200 baud, then the peripheral port 
to which it is attached must also be set for 1 200 baud. 

4662 Plotter. Table 1 2-6 shows one way the switches 
on the TEKTRONIX 4662 Digital Plotter can be set for 
communicating with the terminal through the terminal's 
Option 10 Three Port Peripheral Interface. 



With the 4662's switches set as in Table 1 2-6, the 
following SETUP mode commands will then initialize 
peripheral port zero for communicating with the plotter. 
The terminal remembers these settings even when 
turned off; thus the commands need only be issued 
once, when attaching the plotter to the terminal. 



PBAUD P0: 1 200 



PASSIGN P0: 4662 



PPARITY P0: NONE 
PBITS P0: 1 8 



PFLAG P0: NONE 



Sets port zero to communicate 
with the 4662 at 1 200 bits per 
second. 

Assigns the standard "4662" 
device protocol to peripheral port 
zero. (If the 4662 is equipped 
with multiple pens — Option 31 
— then the second parameter in 
this command should be 
"4662/MP" rather than "4662.") 

Sets peripheral port zero to send 
ASCII characters which have 
eight data bits, no parity bit, and 
one stop bit. 

Disables DTR/CTS and charac- 
ter flagging at the peripheral 
port. (Instead, the plotter's block 
mode is used to prevent data 
overrun.) 



Table 1 2-6 
4662 PLOTTER SETTINGS 



Switch 


Setting 


A 


3 


B 


3 


C 


2 


D 


3 



These switch positions set the 4662 as follows: 

Copy mode. 

CR implies CR-LF. 

GIN terminator = CR. 

Number of stop bits = 1 . 

No Parity. 

Plotter device address = A. 

Baud rate = 1 200. 
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4663 Plotter. Table 1 2-7 shows one way to set the 
4663 plotter's parameter entry switches for use with a 
41 10 series terminal. 



Table 12-7 
4663 PLOTTER SETTINGS 



Parameter 


Setting 


initiai aspect ratio 


4X:3Y 


Initial axis orientation 


Y vertical, X horizon- 


Interface select 


tal 

1 (RS-232 interface) 


Initial command response format 


3 


Serial device address 


A 


Receive baud rate 


9600 


Transmit baud rate 


9600 


Transmit baud rate limit 


Full speed 


vsitaiaoiei iuiihcu 


o uaia uuS, i Siup mil 


Receive parity/transmit parity 


Ignore/logic zero 


Communications control mode 


Full duplex 


Interface functions 


CR generates LF= 




YES, DEL IGNORE= NO 


Attention character 


ESC 


Output terminator 


CR 



Suppose the plotter switches have been set as shown 
in Table 1 2-7. In that case, the following SETUP mode 
commands initialize peripheral port zero in the terminal 
for proper communication with the plotter: 



PBAUD P0: 9600 



Sets peripheral port zero to 
communicate with the plotter at 
9600 bits per second. 



PASSIGN P0: 4663 Assigns the "4663" device pro- 
tocol to peripheral port zero. 

Sets peripheral port zero to send 
ASCII characters which have 
eight data bits, no parity bit, and 
one stop bit. 

Disables DTR/CTS and charac- 
ter flagging. (Instead of flagging, 
the plotter's block mode protocol 
is used to prevent data over-run.) 



PPARITY P0: NONE 
PBITS P0: 1 8 



PFLAG P0: NONE 



<SPOOL> TO A PLOTTER 

One way to transfer data from the host computer to a 
plotter is with the < copy> command. If the plotter is 
connected to port zero, this command would be: 

< copy: "HO:", "TO", "P0:"> 

However, this will tie up the terminal, and the host-to- 
terminal data communications line, for the entire time 
that it takes the plotter to draw the picture being sent. 

If the terminal is equipped with a disk drive, a better 
technique would be to <copy> the data to a file on the 
disk drive, and then <spool> the data from that disk 
file to the plotter: 

<copy: "HO:", "TO", "FO:TEMPFILE"> 
< spool: "FO:TEMPFILE", "TO", "P0:"> 

Here, the < copy> operation takes a comparatively 
short time, since data can be transferred to a disk file 
at a far faster rate than the plotter can plot that data. 
The <spool> command then sets up a "background" 
data transfer. The operator (and the host computer) 
can use the terminal for other purposes while the data 
is being < spool> ed from the disk file to the plotter. 

The terminal's operator can gain similar benefits by 
using the SETUP mode SPOOL command. For instance, 
rather than typing 

SAVE SEG 5 TO PO: 

the operator might type 

SAVE SEG 5 TO FO:TEMPFILE 
SPOOL FO:TEMPF!LE TO PO: 

Once the SPOOL command has been typed, the 
operator can then type other commands to the terminal 
(or to the host), while the < spool> operation proceeds 
in the background. 



NOTE 

< Set-Graphtext-Size> and < Set-Graphtext- 
Rotation> are not translated to plotter com- 
mands by the plotter device drivers. If you have a 
file with either of these commands in it, make the 
file into a segment (if it does not already contain 
segments) by using the <Begin-Segment> com- 
mand, loading the file, and the <End-Segment> 
command. Then save the segment to the plotter. 
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< SAVE> ING SEGMENTS TO A PLOTTER 

Details of Data Sent When <Save>ing a 
Segment 

When a segment is <save>d, the data sent to the 

< save> command's destination is arranged so as to 
permit a plotter to draw that segment correctly. 

That is, the data sent to a < save> command's 
destination consists of 41 1 0-series escape-sequence 
commands, in the following order: 

1 . A < set-pivot-point> command, establishing the 
pivot point for the segment whose definition fol- 
lows. 

2. Commands to set segment attributes for "segment 
minus two." "Segment minus two" means "the 
default for segments not yet defined." Thus, these 
commands establish segment attributes for the 
segment whose definition follows. These attributes 
include visibility, display priority, writing mode, 
image transform parameters (x- and y-scale fac- 
tors, rotation angle, position), highlighting, 
detectability, and the segment classes to which the 
segment belongs. 

3. Finally comes the segment definition itself. This 
includes a < begin-segment> command, the con- 
tents of the segment (moves, draws, alphatext, 
graphtext, primitive attributes, etc.), and an < end- 
segment command. 

The segment attributes are sent before the segment 
definition (as attributes of "segment minus two"). That 
way, the plotter "knows" these attributes before it 
draws the segment. 

Consequently, if you < save> a segment to a disk file, 
and then later < load> that file, you also < load> 
attributes for "segment minus two." That is, < load> ing 
a segment also changes the attributes for "segment 
minus two." 



Using the < Spool > Command 

You can, of course, issue a < save> command to send 
a segment definition directly to a plotter. For instance, 
if a plotter is connected to port zero, the operator can 
type this SETUP mode command: 

SAVE SEG 3 TO PO: 

However, this ties up the terminal for the entire time it 
takes for the data to be sent to the plotter. A better way 
would be to use the <spool> command: 

SAVE SEG 3 TO F0:SEGMENT3 
SPOOL F0:SEGMENT3 TO PO: 

<PLOT> COMMAND 

The < plot> command is similar to the < save> 
command; the difference is that is saves all visiblie 
segments. In SETUP mode, the operator types this 
command as follows: 

PLOT TO PO: 

or 

PLOT TO FO:THISVIEW 
SPOOL FO:THISVIEW TO PO: 

The first example < plot> s all visible segments directly 
to the plotter attached at peripheral port zero. The 
second example is more efficient of the operator's time: 
it saves all visible segments as escape-sequence 
commands in the file FO:THISVIEW, and then 
< spool> s the data in that file to the plotter at port 
zero. Once the SPOOL command has been typed, the 
operator can use the terminal for other purposes while 
the data is transferred to the plotter. 

The escape-sequence syntax for the < plot> command 
is as follows: 

<plot>=(ESC)(P)(L) 

< string: empty-string or "TO"> 

< string: destlnation-specifier> 
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<PORT-COPY> COMMAND 

The commands described so far for drawing pictures 
on an external plotter all take advantage of the 
terminal's capability of translating 41 10-series es- 
cape-sequence commands to equivalent commands for 
the plotter. 

However, you may wish to control the plotter directly 
from a host program, without the terminal's firmware 
intervening. The < port-copy> command provides this 
capability. 

The < port-copy> command establishes a bidirection- 
al data path between the host computer and an RS-232 
peripheral port, or between two RS-232 peripheral 
ports. The command has this syntax: 

< port-copy > = (ESC)(P)(C) 

< string: source-specifier> 

< string: empty-string or "TO"> 

< string: destination-specifier> 

Here, the "source" and "destination" are the two ends 
of the data path. For instance, the following command 
establishes a bidirectional data path between the host 
computer and peripheral port one: 

< port -copy: "HO:", empty-string, "P1 :"> 

= (ESC) (PMC) 

< string: "HO:"> 

< string: empty-string> 

< string: "P1:"> 

= (ESC)(P)(C)(3)(H)(O)(:)(0)(3)(P)(1)(:) . 



The data path remains in effect (that is, the terminal 
continues to execute the <port-copy> command) until 
either the "source" or the "destination" sends an end- 
of-file string. (If the terminal's block mode is being used 
at the host port, then the host terminates the < port- 
copy> by sending a block with the end-of-file bit set.) 
At the host port, the "end-of-file string" is the < EOF- 
string> set by the most recent < set-EOF-string> 
command. At an RS-232 peripheral port, the "end-of- 
file string" is the string set for that port by a <set-port- 
EOF-string> command. 

For an RS-232 peripheral port to be valid as a source 
or destination in the < port-copy> command, a < port- 
assign> command must have assigned the "PPORT" 
device protocol to that port. 

For more details on the < port-copy> command, see 
the description of that command in the 41 1 Series 
Command Reference Manual. 
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USING OTHER RS-232 DEVICES 

You can use the terminal's Option 10 Three Port In particular, the PPORT (general purpose peripheral 

Peripheral Interface with other RS-232 devices than port) device protocol should be < port-assign> ed to 

those described in this sectin. Of course, you must be any port which is not being used with plotters or 

sure to set the port parameters in a way which is printers, 

compatible with those devices. 

The other port settings (port baud rate, port parity, etc.) 
will depend on the requirements of the particular 
peripheral device. 
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USING 4010-SERIES GRAPHICS PROGRAMS 



RUNNING EXISTING 4010 SERIES PROGRAMS 



Programs written for earlier TEKTRONIX terminals 
(401 Series) were written without a dialog area in 
existence. They assume alphatext will be output begin- 
ning at the current graphic cursor position. This is not 
the case on the newer 411 4 terminal if the dialog area 
is enabied. To run eariier programs on the 41 1 4, 
without modifying those programs, the 41 1 4's dialog 
area must be disabled. (See the descriptions of the 
enable-dialog-area in Section 4 of this manual and in 
the 41 10 Series Command Reference Manual.) 

NOTE 

On the other hand, if you want to take advantage 
of, and allow for, the 411 4's dialog area, you can 
very easily modify earlier programs to do so. This 
involves making sure the program uses the 
< graphic-text> command to output all alphatext 
destined for the graphics area. (See the descrip- 
tions of the <graphic-text> command in Section 
7 of this manual and in the 41 10 Series Com- 
mand Reference Manuai.) 



The 41 1 4A can emulate the character sizes of both the 401 4 
and the 401 6. The <select-alphatext-size-group> com- 
mand changes the results of the < set-401 4-alphatext- 
size> to emulate either 401 4 or 401 6 sizes. 

The easiest way to emulate 401 4 or 401 6 character sizes is 
to specify which one you want to emulate with < select- 
alphatext-size-group> and then issue a < set-401 4- 
alphatext-size> command. The < set-401 4-alphatext- 
size > command lets you select one of four standard text 
sizes. The < set-alphatext-size > command can do the 
same thing, but is less convenient to use, since you must 
supply complete specifications for the text size. See the 
41 1 Series Command Reference Manual for details of 
these commands. 



EMULATING 401 SERIES TERMINALS WITH 
4953/4954 GRAPHICS TABLETS 



The 4114 can emulate 401 Series terminals with 
accessory graphics tablets. To do this, the 41 1 4 must 
have a graphic tablet installed (Option 1 3 or 1 4). With 
Option 1 3 or 1 4 installed, the 41 1 4 can emulate a 
TEKTRONIX 401 Series terminal which has an 
accessory TEKTRONIX 4953 or 4954 Graphics Tablet. 

There are four commands used for the emulation: 

• <Enable-4953-Tablet-GIN> 

• < Disable-4953-Tablet-GIN> 

• < Set-Tablet-Header-Characters> 

• < Set-Tablet-Status-Strap> 



For descriptions of these commands, see the 41 1 
Series Command Reference Manual. The description of 
the <enable-4953-tablet-GIN> command is especial- 
ly important; it includes a table showing the commands 
which you can give the 41 1 4 in order to emulate strap 
settings on the 4953/4954 Tablet Controller board. 
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Appendix A 
ASCII CHARTS 



This appendix includes a standard ASCII code chart 
and additional ASCII code charts which define the 
specific characters used as parameters (indicated by 
unshaded areas). 



The code charts are: 
Table Description 

A-1 ASCII Code Chart 

A-2 Characters Used in < Char> Parameters 

A-3 Characters Used in < lnt> and < lnt+ > 

Parameters 
A-4 Characters Used in < lnt-Report> 

Parameters 
A-5 Characters Used in < Xy> Parameters 
A-6 Characters Used in < Xy-Report> 

Parameters 



Table A-1 
ASCII (IS0-7-US) CODE CHART 





B 


'B6 


B5 


\ 


'•1 


-1 




■', 


'•. 


1 


11 


^ 


BITS 

B4 B3 B2 Bl 


CONTROL 


FIGURES 


UPPEF 


(CASE 


LOWERCASE 














NUL 




DLE 

16 


SP 

32 




48 


@ 

64 


P 

80 


\ 
96 


P 

112 











1 


SOH 

1 


DC1 

17 


! 

33 


1 

49 


A 

65 


Q 

81 


a 

97 


q 

113 








1 





STX 

2 


DC2 

18 


34 


2 

50 


B 

66 


R 

82 


b 

98 


r 

114 








1 


1 


ETX 

3 


DC3 

19 


# 
35 


3 

51 


c 

67 


s 

83 


c 

99 


s 

115 





1 








EOT 

4 


DC4 

20 


$ 
36 


4 

52 


D 

68 


T 

84 


d 

100 


t 

116 





1 





1 


ENQ 

5 


NAK 

21 


% 
37 


5 

53 


E 

69 


u 

85 


101 


u 

117 





1 


1 


ACK 

6 


SYN 

22 


& 

38 


6 

54 


F 

70 


V 

86 


f 

102 


V 

118 


l iH ! 1 


BEL 

7 


ETB 

23 


39 


7 
55 


G 

71 


w 

87 


g 

103 


w 

119 


10 





BS 

8 


CAN 

24 


( 

40 


8 

56 


H 

72 


X 

88 


h 

104 


X 

120 










1 


HT 

9 


EM 

25 


) 

41 


9 

57 


I 

73 


Y 

89 


i 

105 


y 

121 







1 





LF 

10 


SUB 

26 


* 

42 


58 


J 

74 


z 

90 


J 

106 


z 

122 


1 1 1 1 


1 


VT 

n 


ESC 

27 


+ 
43 


5 

59 


K 

75 


r 

91 


k 

107 


{ 
123 


iii!0 





FF 

12 


FS 

28 


44 


< 

60 


L 

76 


\ 

92 


I 

108 


1* 

124 


1!1 

I 





1 


CR 

13 


GS 

29 


45 


6! 


M 

7^ 


1 
93 


m 

109 


} 

125 


i:i 


1 





SO 

14 


RS 

30 


46 


62 


N 

78 


A 

94 


n 

110 


126 




1 


1 


1 


SI 

15 


US 

31 


/ 

12 


7 

63 




79 


_ 95 




in 


RUBOUI 
(DELI 
127 
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ASCII CODE CHARTS 



Table A-2 
CHARACTERS USED IN <CHAR> PARAMETERS 





B7 a 


; B5 


% 


% 


1 | , 
I 1 


m, 


■ 


r\ 


SB 


84 B? ill r: 


CONTROL 


FIGURES 


UPPERCASE 


mwmcms 








: 





Mi 11 
NUL 




ni c 

bit 
?6 


CD 

or 

32 


U 

48 


@ 

64 


P 

80 


\ 

96 


P 

7 72 











1 


SON 

:■■■■■ -:7: 


DC1 

''■:■ ■■'■■■:!? 


1 

33 


1 

49 


A 

65 


Q 

81 


a 

97 


q 

773 








1 





STX 


DC2 

78 


it 

34 


2 

50 


B 

66 


R 

82 


b 

98 


r 

7 74 








1 


1 


ETX ' 


DC3 


# 
35 


3 

51 


c 

67 


s 

83 


c 

99 


s 

775 





1 








COT 

4 


DC4 


$ 

36 


4 

52 


D 

68 


T 

84 


d 

700 


t 

776 






1 





i 


ENQ 

a 


NAK; % 


5 

53 


E 

69 


u 

85 


e 

707 


u 

777 


1 


1 





r ACK 

L 5 


SYN 


& 

38 


6 

54 


F 

70 


V 

86 


f 

702 


V 

778 





1 


1 


1 


BEL 

? 


ETB 


/ 

39 


7 

55 


G 

77 


w 

87 


g 

703 


w 

779 


1 











BS ' 

8 


CAN 


( 

40 


8 

56 


H 

72 


X 

88 


h 

704 


X 

720 


' 








1 


HT 

3 




) 

41 


9 

57 


1 

73 


Y 

89 


i 

705 


y 

727 


i: 





1 





IF 

to 


SUB 


* 

42 


■ 
■ 

58 


J 

74 


z 

90 


J 

706 


z 

722 


- 





1 


1 


a 


ESC 

mmm. 


+ 
43 


■ 

59 


K 

75 


[ 

91 


k 

707 


{ 
723 


i 


1 








FF 

;2 


FS" 1 

23 


44 


< 

60 


L 

76 


\ 

92 


I 

708 


r 

724 


7 


1 





1 


CR 

v3 


GS 

29 


45 


61 


M 

77 


] 

93 


m 

709 


} 

725 


1 


1 


1 





SO 

74 


RS 

30 


■ 

46 


> 

62 


N 

78 


A 

94 


n 

770 


726 


1 


1 


t 


1 


SI 

75 


US 

37 


/ 

47 


1 

63 




79\ 


~~ 95 




777 


W80UT 

f»4 
127 
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ASCII CODE CHARTS 



Table A-3 
CHARACTERS USED IN <INT> AND <INT+> PARAMETERS 



<Hil> Characters 



< Lol> Characters 



• 


•».r«i! 


jipilllfil 


■•. 


1^ 


[s 


i t 


CONTBOi j 


UPPERCASE 


LOWERCASE 


1 1 1 

- ' 1 


N 

■ 


■ 

I J 
Hlili 


1 

2 


@ 

64 


P ! X 

80l 96 


P 

112 


■ 
— ' 


SOH DC! 

liliiliisKi' 

Sl> 'DC2 


A 

65 


Q 

8; 


a 

97 


q 

113 


B 

66 


R 

82 


b 

98 


r 

114 


EJX J DC3 i 
KIT "DC4 ' 


i : 

ad. 

$ i 


1111 


c 

67 


s 

83 


c 

99 


s 

115 


4 


D 

68 


T 

84 


d 

100 


t 

116 


E.NC NAK_ 

illiSiill 
'..„.■■. 


J7 


r. 

BlslsiSi 
S3 


E 

69 


u 

85 


e 

10! 


u 

117 


B;ili|a 


& 


III 
ESS* 

7 


F 

70 


V 

86 


f 
10? 


V 

118 


- 


bei. nr» 


G 

71 


w 

87 


g 

103 


w 

119 


t Bl0J3 


iiiiiiiiii 

it, _><r t 




8 

1111 


H 

72 


X 

88 


h 

104 


X 

120 




iiiiiiiiii 
j - 


) 


I 

73 


Y 

89 


1 

105 


y 

121 


■ 


LF SU6 


* 


§i!8f 


J 

74 


z 

90 


j 
106 


z 

122 


1 Bhh 


iiiiipiiii 

Itj ?7J 


+ ! 




K 

75 


[ 

9) 


k 

107 


{ 
123 


l||ll|i|l 


rr 1 ro 

If 1 1 O 1 

u! at 


Mill 


I 

L 
76 


\ 

\ 
92 


1 
108 


I * 
1 

124 


1j1l0l1 


CR GS 


f$i 


M 

77 


] 
93 


m 

109 


} 

125 


i ! ■ .1 


SO RS 

!J .„■■ 


t 


11! 
? ; 

as! 


N 

78 


A 

94 


n 

110 


126 


1 


51 US 

- 




79 


_ 95 




in 


RUBOUT 
I0EI] 
127 



w a 


r. 




"'■:.. : 


v* 


-£- 






BITS 


CONTROL 


: . 


:0j3i8 




1 

j 


uir ' 

a! 


SP 


n N 


f ; 
A ! 

b r 


p : 

Siili 

liiii 


x 1 p 

W fig 

3 "I q 

b rr 

<Mtj 114 




SOH; 


DC! 1 

5 ? i 


1 


1 F 


8 8(1 jl 


STX 

ETX : 

| 


DCS 

JO 




2 


# 





C I 

f 


■ : s-:-:!- : 

f 


c ■ :■ 

1 : t " 

I0<| JfS 


lill 


1 


$ 


4 


•.<.)!« 




enqI 

"MJkI 


NAI 

synI 


% 


5 


'■' ' ' "-' 


& 


■ 


f i 

G 1 


V 

w 


{ i V 


SStltl 
liliilii 


liliiill! 

bs "can" 

8 




7 | 


( 


8 


H 5 

? I 

j 

K 


X 

Mi 

lllll 

■••1 


h 1 x 

. „ m. 122 

t j y 


* - 


MT 


EM 


) 


9 


1 jail :0 


LF ? 

Fiji 


SUB 

25 


* 




z 

lllll 


k * { 


Ippip 

... . » . 
IITJ8 ; 


k fji 

rr J 
M 


rsc 

- 

FS 

28: 

GS ■ 


+ 


' $■ 


44 


I 


t 

76| 

M j 

n 

„ ^ 

! 


: EIS£ 

M 


i 1*1 

1 ; I 
__ p_ 


■ 


liii 


45 


= 


i i ' i :0 


SO : 

sTl 


MS 
g 

US ;" 




> 1 


ii • 






? -* 


S5 


8 us 
• t *i" 1 
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ASCII CODE CHARTS 



Table A-4 
CHARACTERS USED IN < INT-REPORT> PARAMETERS 



<Hil-Report> Characters 



l'ip, 

« m s? Si 


S 8 






MS 1 


i — n — 

OWERCASC 


LOWERCASE 


(&ms??^ 


FKJUS 




BJBJeia 


NIJL DL 


SP 




48 1 


@ 

64 


P 


> feS 

9? 


P 

Ifi 


00!b:i 

O|0|l)8 


SOH 

SIX 


i)i;l 


1 


1 

49[ 


A 

g5 


Q w 


DC2 


" 


2 


B 


R 


b 

gp 

c 

d 

_. us 
e 


f 

s 

. !25 

t 

„ y<S 

U 

ft? 


1 ; S 


ETX i DCS 
EOT 0C4 

1 JO 


# i 


3 


C 


S 


$ i 

36 


4 


D 


T 

84 




ENQ NAK 

"Wj SYN ~ 

g 2? 


% 


5 


E 


U 


& 


6 

54 1 


F 


V 

86 


f 


V 

IS 


a; i : i h 
i <o|0|e 


BEL EIB 


i 


7 


G 


W 

87 


( 

40 


8 

56 


H 


X 

88 


ti 




■ 3 a i 


HI fM 

| i|j SIS 


) 


9 


I 


Y 

g9 


i 


y 


1 0|l 1 


LF 


SUB 


* 

42 




J 


Z 

90 


i 


; 

12! 


ESC- 


+ 


59 i 


K 


[ 


ti 


{ 

m 


1 1 1' 


FF 

1 is 


rS 

6S 


44 j 


60 


L 


\ 

92 


t 

m, 

in 

199 


m 


13 


- 


= 


M 


1 

93 


■ • i c 

— p~i" — r - ■ 


SO 

I 


RS 


46| 


_ 


N 

78 


94 


n 


--. 

m 

1?7 


us 


/ 


7 

63| 




79 


- M 





<Lol-Report> Characters 



7 


BS 


: - ■■■ :■ ■■■. »■ 

COMTftOl PIOUftES 


■ 

1 a ) "i 


*u 


1 


■■■ 5 ., ", 


upomcAse 


UJik'KJ&V'f.E 


90 oh 


NJL : Oi L ' SP 

8 M*| 32 





'.S\ 64. SC 


V l P 

a q 

b 1 r 


SOH ■: DCl ! 

r 17 33 


1 


A * Q 


• 


SIX 1 BC2 " 

?! *S 34 


2 


BR 

■M «C S." 


ETX Oil # 

3 13 35 


3 


c s 

■ 


■m Ms 

a n 

r.Tf • « 


EOT * 0C4 $ 

,.. 4{„ . «» 36j 


4 


■ D : f 
>■■■ 


ENQ I NAK % 

& JH, 37 


5 


E U 


8 | ti 

. — ffltL — m 

t i if 


,- - 1 


ACH ] SYN & 

1 S>, 38! 


6 


F 

■IT 


8£L | £TS ' 

T] 2$\ 39 


7 


Ml 


g t W 


i e • e j i 


as 1 m ( 


8 


pfiiiBiiff 

"• , .■•■.. ... •'> 


HT ! CM ) 

3 » 


9 


, — m 

i 


y 

1?' 


1 Bit |» 


If I SiiB * 

•f, 2$\ 42 


: 


j 7 

■j ;k- 


z 


1 in 


rr ! esc + 

l • •'.. Si «i 


1 


K 1 
■I Bj a 

I \ 


k i 1 


FF f FS ' , 

I? 2*\ 44 




J 1 10 




CP J GS j - 


= 


Ml 


■15 
. J28 




: l j" 


- 


SO 1 RS . 




N A 


' L 


■ 


SI ? US ' / 

IK $1\ 47] 


7 


, ... 




ft) 





in <Byba»rd« Or jyilem; 



A4 



<a) 
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Table A-5 
CHARACTERS USED IN <XY> PARAMETERS 



<HiY>,<HiX> Characters 



ASCII CODE CHARTS 



nrs 



; ' i 



aipiiii 



(ill flu 

J 'ill 



lliiii 



< s lj.t 



— 



till 



MMl-V 



IgilEin 



3; 

30H Ul i ' 






ptv %y 



t"T DCii 






ACK S¥N 



PEi. FTB 



* J f 


;■ 


lllll 


n 




><*m 


:- 




R 


■ « .:: 


*-■: 


;f"l"; 


«*' 






, 


ft-1 


" 


« : 


■;=■::;:«?& 


„.,. 


fiiNsHii 




D: 


]• I 


fl 


' 


" -S3 


Ml 




••« 



H 



<LoY> i < Extra > Characters 



r v 

G ' ' W 



w cw 

B:ii;M|iNIp5S;|| 

-. ' ) 

u ' si.m hr 

_■..'" : 



s-s 



■IIHI 
Si) r's" 



5 



:t.US ' 

itSiSH. 



H • X 

— sj 

j > y 

' ; ■■ 

_ * __ 
"h "' 

JSJ 

ij:jjjjj;jinj^| ;;h|:;;;;;=;;: 

"n.TT 



c _ 





t^ 


s; - 


c 


------- 


ij 


!■- 




: . 




!!;;iypiiiHa:::lll 


- T. 


'" 


~~ tOWSBGWK 


• ■ 


(iff 


- 


Si! 


SF 

L .: 


i ~ 


• 

Illllp 

■■■: «f 


it-- 

BillH 


96 


p 

112 


>Cii 

t 


DC! : 


97 


q 

J73 


ileitis 

liiiili 




JC? 


- - "J _^ 

- # 


2 

[ »• 


e ; 

■ 


b 

9a 


r 

174 


Ff.\ 


DC3 


iiiii! 

sL 

i™ itak 


" Hi 

-T .. 


C 

99 


775 


■ 


EOT 


DC4 


$ 

S!!!!!=!=!!;lli|p 


■1 

5 
_ .. 


d 

100 


t 

116 


: l', 1 




ENQ 


NAK 

■ - - 7 . 


_4 

.f. ! 


BiiiiB 


e 

JO? 


u 

177 


kjii 




ACK 

-ft 


S¥N 

- : ■■ '12 


S 


6 

-■ 


f 

102 


V 

US 


iippji 


.. 


a 




■■ 

H " 
?i: ■ 


■ .S3 


g 

703 


W 

119 


■ .■ L' f 


■-:8S-: 

- rt 


CAN 


■iii 


h 

104 


X 

120 




ETf.J ; 1 


- ' "' -5' 




v-= ■ 

BilphB:::: 

JliBi 


105 


y 

121 


lljljl 


sua 

■ill 

LSC 

■?'. 


• 
■ ^ 


£2k 


2 
Jlil 

( 
. .: a: 

IP. 

■■■■'■• 

! 


TOS 


2 

122 


■'.'.■ 


VT 

FF 
CR 1 


+ 


; ■ 


k 

107 


{ 

123 


FS . 
.■- c 

liiiiiii 


<■ ■■ L : [ 

ri: -ff" 


1 
70S 


1* 

124 


1:1 »jt 


m 

J09| 


} 

125 


• 


SO 

■ ■ 14 


RS 
—39 

us ! 

,1 




llHliiiill 


n 

7JO 


126 






;;;;;:J::ii;;; 


.. . 

> 

S3! ft 


~ « 




in 


RUBOUT 

oai 

127 



<LoX> Characters 



aiiliii 

_ £ j 



Sill 

:fiC3 



% 20 - ■■ .J»l - . il \ 

M - 



,.„. ,., :■- g|__^»| 



ETB 

ss apta v,.,.v,M r-. '* ' " 



ale 1 1 



'i' \t'» 



: ■■ - 



:LF: 



VT 



FF FS 



_ii_ 



(5) 



«4 -"-° 



■■ 8 ■■ t V 
»H '« | 

b 






CR 



IBS: 



lUl 



^L 



m, 



-SI- 



RS 

us / r 






am 



u 
T" 

IT 
X 

Y 



at. 

5 1 ^ ! 
v ! 

B " ■ 



h s 

1W - )20 

* : J y 



J- 



- 

I | (* 

92 [ SMJ. tM 

m ia 



T mKTl 
- I +""' 
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Table A-6 
CHARACTERS USED IN <XY-REPORT> PARAMETERS 



<HiY-Report>, < Ext ra- Report >, <LoY-Report>, 
<HiX-Report>, and <LoX-Report> Characters 





B7 


B5 


^ r 
» 


^ 


1 


1 » 


1 S 


1 2 '1 


— * 


:ii: 


Bits 

B4 E3 tL ! PI 


CONTROL 


FIGURES 


UPPERCASE 


tOW£BC*Sg 





© 





Iff 


NUL 


OIF 

76 


SP 

32 




48 




p 

80 


'■".■v : . '■ 


n 

r 

. wm. 











• 


SOH 

■' : :/. 


DC1 


! 

33 


1 

49 




Q 

8? 


a 

'". :• 97 


113 





H 


1 





SIX 
: : : ; :v:::.-; : ;:.;i 


0C2 


34 


2 

50 


8 

66 


R 


b 

9S 


". r ■■' 

V4 








1 


1 


ETX 

.? 


DCS 

13 


# 
35 


3 

57 


c 


S 

85 


■' ■ C ■ ' 

$9 


s 

7-T5 





1 








EOT 

4 


DC4 


$ 

36 


4 

52 





T 

84 




t 

I, « 6 





' 





1 


ENQ 


NAK 

2? 


% 
37 


5 

53 


E 


U ., 


e 

._ 101 


■ U ' 





1 


• 





ACK 


SYN 


& 

38 


6 

54 


F 

70 


V 


f 
8& 


V 

H8 





1 


- 


' 


BEL 

t 7 


ETB 

:>3 


/ 
39 


7 

55 


G 

77 


w 

87 


I 
J 09 


w ■ 

r*9 


>■ 


- 





BS 


CAN 

24 


( 

40 


8 

56 


H 

"2 


X 

881 


h 

104 


■ -X' ■' 

720 


; 





- 


' 


HT 


EM 


) 

41 


9 

57 


I 

75 


Y 

89 


i 

105 


y 

mi 


* 





1 





If 


SL B 


* 

42 


m 

58 


J 

74 


2 

gel 


-C6 


.2 '' 

??2 


i 









VT 


ESC 

.. ■ 


+ 
43 


■ 

J 

59 


K 

75 


r 

.9? 


k 


i 


1 
i 







3 


FF ' 


FS 

28 


j 

44 


< 

60 


L 


\ 


7J08 


r 


1 





1 


CR 1 


GS 

29 


45 


61 


(VI 

77 


3 

S3 


ffl 

•<2| 


i 

r*5 


i 


1 


1 





SO 

14 


RS 

30 


■ 

46 


> 

62 


N 

78 


A 

9-* 


n 


fl<6 


r 


1 


1 


I 


SI 

, ,,, '.£ 


US 
3 * 


/ 

47 


? 

' sa 




79 


— 95 




171 


(DEU 

... *?'i 
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Appendix B 



EXAMPLES OF <INT> PARAMETERS 



Table B-1 lists <int> parameters for integers between —1049 and + 1049. 



Table B-1 
REPRESENTING NUMBERS AS <INT> PARAMETERS 



n < Int : n> 


— n <lnt:— n> 


n 


<int : n> 


— n 


<int : — n> 


n 


<lnt : n> 


— n 


<int : — n> 


"0 (0) 


-0 (SP) 


50 


(C)(2) 


-50 


(CH") 


100 


(F)(4) 


-100 


(F)($) 


1 (1) 


-1 (!) 


51 


(C)(3) 


-51 


(CH*) 


101 


(F)(5) 


-101 


(FM%) 


2 (2) 


-2 (") 


52 


(C)(4) 


-52 


(CHS) 


102 


(F)(6) 


-102 


(FM&) 


3 (3) 


-3 i#) 


53 


(CH5) 


-53 


(C)(%) 


103 


(F)(7) 


-103 


(F)C) 


4 (4) 


-4 ($) 


54 


(C)(6) 


-54 


(C)(4) 


104 


(F)(8) 


-104 


«=)("(") 


5 (5) 


-5 (%) 


55 


(C)(7) 


-55 


(C)C) 


105 


(F)(9) 


-105 


(F)C')") 


6 (6) 


-6 (4) 


56 


(0(8) 


-56 


(C)("(") 


106 


(F)(:) 


-106 


(FH*) 


7 (7) 


-7 n 


57 


(C)(9) 


-57 


(OH") 


107 


(F)(;) 


-107 


(FM+j 


8 (8) 


-8 ("(") 


58 


(CH:) 


-58 


(CM*) 


108 


(FM<) 


-108 


(FH,) 


9 (9) 


-9 (")") 


59 


(CM;) 


-59 


(C)(+) 


109 


(F)(«) 


-109 


(FH-) 


10 (:) 


-10 (•) 


60 


(C)(<) 


-60 


(CH,) 


110 


(FH>) 


-no 


(FH.) 


11 (;) 


-11 (+) 


61 


(C)(=) 


-61 


(CM-) 


111 


(FM?) 


-111 


(FH/) 


12 (<) 


-12 (,) 


62 


(C)(>) 


-62 


(CH.) 


112 


(G)(0) 


-112 


(GXSP) 


13 (=) 


-13 (-) 


63 


(CH?) 


-63 


(CH/) 


113 


(G)(1) 


-113 


(GM!) 


14 (>) 


-14 (.) 


64 


(D)(0) 


-64 


(DHSP) 


114 


(G)(2) 


-114 


(G)(") 


15 (?) 


-15 (/) 


65 


(D)(1) 


-65 


(DH!) 


115 


(G)(3) 


-115 


(G)(#) 


16 (A)(0) 


-16 (AMSP) 


66 


(D)(2) 


-66 


(DH") 


116 


(G)(4) 


-116 


(G)($) 


17 (A)(1) 


-17 (AM!) 


67 


(D)(3) 


-67 


(DH#) 


117 


(G)(5) 


-117 


(GH%) 


18 (A)(2) 


-18 (AM") 


68 


(D)(4) 


-68 


(D)($) 


118 


(G)(6) 


-118 


(G)(4) 


19 (A)(3) 


-19 (A)(#) 


69 


(D)(5) 


-69 


(D)(%) 


119 


(G)(7) 


-119 


(G)C) 


20 (A)(4) 


-20 (A)($) 


70 


(D)(6) 


-70 


(D)(4) 


120 


(G)(8) 


-120 


<GH"(") 


21 (A)(5) 


-21 (A)(%) 


71 


(D)(7) 


-71 


(D)C) 


121 


(G)(9) 


-121 


(GH")") 


22 (A)(6) 


-22 (A)(4) 


72 


(D)(8) 


" -72 


©)("(") 


122 


(G)<:> 


-122 


(GH*) 


23 (A)(7) 


-23 (A)C) 


73 


(D)(9) 


-73 


(DM")") 


123 


(GM;> 


-123 


(GH+) 


24 (A)(8) 


-24 (A>m 


74- 


(DH:) 


-74 


(DM*) 


124 


(GM<) 


-124 


(GH,) 


25 (A)(9) 


-25 (AH")") 


75 


(DH;) 


-75 


(D)(+) 


125 


(GM=) 


-125 


(GH-) 


26 (A)(:) 


-26 (A)<*) 


76 


(DH<) 


-76 


(DH,) 


126 


(G)(>) 


-126 


(GH.) 


27 (AH;) 


-27 (A)(+) 


77 


(DH= ) 


-77 


(DH-) 


127 


(GM?) 


-127 


(GM/) 


28 (A)(<) 


-28 (A)(,) 


78 


(DH>) 


-78 


(DM.) 


128 


(HMO) 


-128 


(HMSP) 


29 (A)(=) 


-29 (AH-) 


79 


(DH?) 


-79 


(DH/) 


129 


(HMD 


-129 


(HM!) 


30 (A)(>) 


-30 (A)(.) 


80 


(E)(0) 


-80 


(EMSP) 


130 


(H)(2) 


-130 


(H)(") 


31 (A)(?) 


-31 (AH/) 


81 


(E)(1) 


-81 


(EMI) 


131 


(H)(3) 


-131 


(H)(#) 


32 (B)(0) 


-32 <B)(SP) 


82 


(E)(2) 


-82 


(EM") 


132 


(H)(4) 


-132 


(H)($) 


33 (B)(1) 


-33 (B)(!) 


83 


(E)(3) 


-83 


(E)(#) 


133 


(H)(5) 


-133 


(H)(%) 


34 (B)(2) 


-34 (B)(") 


84 


(E)(4) 


-84 


(EMS) 


134 


(H)(6) 


-134 


(H)(4) 


35 (B)(3) 


-35 (B)(#) 


85 


(E)(5) 


-85 


(E)(%) 


135 


(H)(7) 


-135 


(H)C) 


36 (B)(4) 


-36 (B)($) 


86 


(E)(6) 


-86 


(EM&) 


136 


(H)(8) 


-136 


«)("(") 


37 (B)(5) 


-37 (B)(%) 


87 


(E)(7) 


-87 


(E)C) 


137 


(H)(9) 


-137 


(HH")") 


38 (B)(6) 


-38 (B)(4) 


88 


(E)(8) 


-88 


(EM-(") 


136 


(H)(;! 


-138 


(H)(*) 


39 (B)(7) 


-39 (B)C) 


89 


(E)(9) 


-89 


(EM")") 


139 


(H)(;) 


-139 


(HH+) 


40 (B)(8) 


-40 (B)("C) 


90 


(EH:) 


-90 


(EM*) 


140 


(H)(<) 


-140 


(H)(,) 


41 (B)(9) 


-41 (B)(")"i 


91 


<E)(;) 


-91 


(E)(+) 


141 


(H)(- ) 


-141 


(HM-) 


42 (B)(:) 


-42 (B)(.) 


92 


(EMO 


-92 


(EH,) 


142 


(H)(>) 


-142 


(H)(.) 


43 (B)(;) 


-43 (B)(+) 


93 


(E)(=) 


-93 


(EM-) 


143 


(HH?) 


-143 


(HH/) 


44 (B)(<) 


-44 (B)(.) 


94 


(EX>> 


-94 


(EH.) 


144 


(IMO) 


-144 


(IMSP) 
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(5) 



B-1 



< INT> PARAMETERS 



Table B-1 (Cont) 
REPRESENTING NUMBERS AS < INT> PARAMETERS 



n <lnt:n> 


— n <int : — n> 


n 


<int : n> 


— n <int : — n> 


n 


<lnt :n> 


-n <lnt : -n> 


45 <B)<=) 


-45 (B)(-) 


95 


(EM?) 


-95 (E)(/) 


145 


(IXD 


-145 (l)(!) 


46 (B)(>) 


-46 (B)(.) 


96 


(F)(0) 


-96 (FXSP) 


146 


(IX2) 


-146 (IX") 


47 (B)(?) 


-47 (B)(/) 


97 


(F)(1) 


-97 (F)(!) 


147 


0X3) 


-147 (OOP) 


48 (C)(0) 


-48 (C)(SP) 


98 


(F)(2) 


-98 <F)("> 


148 


(IX4) 


-148 (»($) 


49 (C)(1) 


-49 (C)(!) 


99 


(F)(3) 


-99 (FX#) 


149 


(IX5) 


-149 (l)(%) 


150 (l)(6) 


-150 (l)(&) 


200 


(U<8) 


-200 (LX"<"> 


250 


(OX:) 


-250 (OX*) 


151 (I) (7) 


-151 (DC) 


201 


(L)(9) 


-201 (L)C')") 


251 


(OX;) 


-251 (0X+) 


152 (l)(8) 


-152 (!)<"(") 


202 


«-)(:) 


-202 (L)M 


252 


(0)(<) 


-252 (0)(.) 


153 (l)(9) 


-153 (DC)") 


203 


(L)(;) 


-203 (LX+) 


253 


(0)(=) 


-253 (0X-) 


154 (l)(:) 


-154 (DC) 


204 


(L)(<) 


-204 (L)(.) 


254 


(0X>) 


-254 (OX.) 


155 OH;) 


-155 (!)(+) 


205 


(L)(=) 


-205 (LX-) 


255 


(OX?) 


-255 (OX/) 


ice l\\l^\ 


■« ee> (t\f \ 




n \ i^ \ 










— ijg {*n, I 


<LWO 


\,*-ns t 


-iuo ii-M.; 


2oo 


KfnOt 


—<doo U-'M&rj 


157 (l)(=) 


-157 (IX-) 


207 


(L)(?) 


-207 (L)(/) 


257 


(PXD 


-257 (P)(!) 


158 (l)(>) 


-158 (l)(.) 


208 


(M)(0) 


-208 (MXSP) 


258 


(PX2) 


-258 (P)(") 


159 (l)(7) 


-159 (l)(/) 


209 


(M)(1) 


-209 (MX!) 


259 


(PX3) 


-259 (P)(#) 


160 (J)(0) 


-160 (J)(SP) 


210 


(M)(2) 


-210 (MX") 


260 


(PX4) 


-260 (P)($) 


161 (J)(1) 


-161 (J)(!) 


211 


(M)(3) 


-211 (M)(#) 


261 


(PX5) 


-261 (PX%) 


162 (J)(2) 


-162 (J)C') 


212 


<M)(4) 


-212 (M)($) 


262 


(PX6) 


-262 (P)(&) 


163 (J) (3) 


-163 <J)(#) 


213 


(M)(5) 


-213 (M)(%) 


263 


(PX7) 


-263 (PIC) 


164 (J) (4) 


-164 (J)($) 


214 


(M)(6) 


-214 (MX&) 


264 


(PX8) 


-264 (P)("(") 


165 (J) (5) 


-165 (J)(%) 


215 


(M)(7) 


-215 (M)C) 


265 


(P)(9) 


-265 (PX")") 


166 (J) (6) 


-166 (J)(&) 


216 


(M)(8) 


-216 (MX"(") 


266 


IPX:) 


-266 (PX*) 


167 (J) (7) 


-167 <J)C> 


217 


(M)(9) 


-217 (M)(")"l 


267 


(PX;) 


-267 (PX+) 


168 (J) (8) 


-168 <J)("(") 


218 


(M)(:) 


-218 (MX*) 


268 


(P)(<) 


-268 (PX,) 


169 (J) (9) 


-169 (J)(")") 


219 


(MX;) 


-219 (M)(+) 


269 


(PX=) 


-269 (PX-) 


170 (J)(:) 


-170 (J)(*) 


220 


(M)(<) 


-220 (MX,) 


270 


(PX>) 


-270 (PX.) 


171 (J)(;) 


-171 (J)(+) 


221 


(MX=) 


-221 (MX-) 


271 


(PX?) 


-271 (P)(/) 


172 (J)(<) 


-172 (J)(,) 


222 


(M)(>) 


-222 (MX.) 


272 


(QXO) 


-272 (QXSP) 


173 (J)(=) 


-173 (J)(-) 


223 


(M)(?) 


-223 (M)(/) 


273 


(QXD 


-273 (QX!) 


174 (J)(>) 


-174 (J)(.) 


224 


(N)(0) 


-224 (NXSP) 


274 


(QX2) 


-274 (Q)(") 


175 (J)(?) 


-175 (J)(/) 


225 


(N)(1) 


-225 (NXD 


275 


(QX3) 


-275 (QX#) 


176 (K)(0) 


-176 (K)(SP) 


226 


(NX2) 


-226 (NX") 


276 


(QX4) 


-276 (QX$) 


177 (K)(1) 


-177 (K)(!) 


227 


(N)(3) 


-227 (N)(#) 


277 


(0X5) 


-277 (Q)(%) 


178 (K)(2) 


-178 (K)(") 


228 


(N)(4) 


-228 (N)($) 


278 


(QX6) 


-278 (QX&) 


179 (K)(3) 


-179 (KK#) 


229 


(NX5) 


-229 (NX%) 


279 


(0X7) 


-279 (QIC) 


180 (K)(4) 


-180 (K)($) 


230 


(N)(6) 


-230 (N)(&) 


280 


(QX8) 


-280 (Q)("(") 


181 (K)(5) 


-181 (K)(%) 


231 


(N)(7) 


-231 (NIC) 


281 


(QX9) 


-281 (Q)(")") 


182 (K)(6) 


-182 (K)(&) 


232 


(N)<8) 


-232 <N)("(") 


282 


(QX:) 


-282 (QX*) 


183 (K)(7) 


-183 (K)C) 


233 


(NX9) 


-233 (NX")") 


283 


(OX;) 


-283 (QX+) 


184 (K)(8) 


-184 (K)("(") 


234 


(NX:) 


-234 (N)(«) 


284 


(QX<) 


-284 (QX,) 


185 (K)(9) 


-185 (K)(")") 


235 


(NX;) 


-235 (NX+) 


285 


(QX=) 


-285 (QX-) 


186 (K)(:) 


-186 (KX*) 


236 


(N)(<) 


-236 (NX,) 


286 


(Q)(>) 


-286 (QX.) 


187 (K)(;) 


-187 (K)(+) 


237 


(N)(= ) 


-237 (NX-) 


287 


(QX?) 


-287 (Q)(/) 


188 <K)<<) 


-188 (K)U 


238 


!N)(>) 


-238 (NX.) 


288 


(RXO) 


-288 (RXSP) 


189 (K)(=) 


-189 (KX-) 


239 


(NX?) 


-239 (NX/) 


289 


(R)(1) 


-289 (RX!) 


190 (K)(>) 


-190 (K)(.) 


240 


(0X0) 


-240 (OXSP) 


290 


(R)(2) 


-290 (R)(") 


191 (K)(?) 


-191 (K)(/) 


241 


(0X1) 


-241 (OXD 


291 


(RX3) 


-291 (R)(#) 


192 (L)(0) 


-192 (L)(SP) 


242 


(0X2) 


-242 (OX") 


292 


(RX4) 


-292 (R)($) 


193 (L)(1) 


-193 <U(!) 


243 


(0X3) 


-243 (0)(#) 


293 


(R)(5) 


-293 (RX%) 


194 (L)(2) 


-194 (L)(") 


244 


0X4) 


-244 (0)($) 


294 


(RX6) 


-294 (R)(&) 


195 (U(3) 


-195 <LX#) 


245 


0X5) 


-245 (0)(%) 


295 


(RX7) 


-295 (R)C) 


196 (U(4) 


-196 (L)($) 


246 


0X6) 


-246 (OX&) 


296 


(RX6) 


-296 <RX"(") 


197 (L)(5) 


-197 (L)(%) 


247 


0X7) 


-247 (O)C) 


297 


(RX9) 


-297 (RX")") 


198 (U(6) 


-198 (LX&) 


248 


(0X8) 


-248 (OX"(") 


298 


(RX.) 


-298 (R)(*) 


199 (U(7) 


-199 (DC) 


249 


0X9) 


-249 (OX")") 


299 


(R)(;) 


-299 <R)(() 



B-2 
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<INT> PARAMETERS 



Table B-1 (Cont) 
REPRESENTING NUMBERS AS <!NT> PARAMETERS 



n <lnt:n> 


— n <int:— n> 


n <int:n> 


— n <int : — n> 


n <int:n> 


— n <lnt:— n> 


300 (R)(<) 


-300 (R)(.) 


350 (U)(>) 


-350 (U)(.) 


400 (Y)(0) 


-400 (Y)(SP) 


301 (R)(=) 


-301 (R)(-) 


351 (U)(?) 


-351 (U)(/) 


401 (Y)(1) 


-401 (Y)(!) 


302 (R)(>) 


-302 (R)(.) 


352 (V)(0) 


-352 (VMSP) 


402 (Y)(2) 


-402 (nn 


303 (R)(?) 


-303 (R)(/) 


353 (V)(1) 


-353 (V)(!) 


403 (Y)(3) 


-403 (Y)(#) 


304 (S)(0) 


-304 (S)(SP) 


354 (V)(2) 


-354 (V)(") 


404 (Y)(4) 


-404 (Y)($) 


305 (S)(1) 


-305 (S)(!) 


355 (V)(3) 


-355 (V)(#) 


405 (Y)(5) 


-405 (Y)(%) 


306 (S)(2) 


-306 (S)(") 


356 (V)(4) 


-356 (V)($) 


406 (Y)(6) 


-406 (Y)(&) 


307 (S)(3) 


-307 (S)(#) 


357 (V)(5) 


-357 (V)(%) 


407 (Y)(7) 


-407 (Y)C) 


308 (S)(4) 


-308 (SMS) 


358 (V)(6) 


-358 (V)(&) 


408 (Y)(8) 


-408 (Y) ("(") 


309 (S)(5) 


-309 (S)(%) 


359 (V)(7) 


-359 (V)C) 


409 (Y)<9) 


-409 (Y)(")") 


310 (S)(6) 


-310 (S)(&) 


360 (V)(8) 


-360 (V)("(") 


410 (Y)(:) 


-410 (Y)W 


311 (SK7) 


-311 (S)C) 


361 (VM9) 


-361 (V)(")") 


411 (Y)(;) 


-411 (Y)(+) 


312 (S)(8) 


-312 (S) ("(") 


362 (V)(:) 


-362 (V)(«) 


412 (Y)(<) 


-412 (Y)U 


313 (S)(9) 


-313 (S)(")") 


363 (V)(;) 


-363 (V)(+) 


413 (Y)(=) 


-413 (Y)(-) 


314 (S)(:) 


-314 (S)(*) 


364 (V)(<) 


-364 (V)(.) 


414 (Y)(>) 


-414 (Y)(.) 


315 (S)(;) 


-315 (S)(+) 


365 (V)(=) 


-365 (V)(-) 


415 (Y)(?) 


-415 (Y)W 


316 (SS!<) 


-316 (S)(.) 


366 (V>(>! 


-366 W)(.) 


418 (Z)(0) 


-416 (Z)(SP) 


317 (S)(=) 


-317 (SK-) 


367 (V)(?) 


-367 (V)(/) 


417 (Z)(1) 


-417 (Z)(!) 


318 (S)(>) 


-318 (S)(.) 


368 (W)(0) 


-368 (W)(SP) 


418 (Z)(2) 


-418 (Z)(") 


319 (S)(?) 


-319 (S)(/) 


369 (WHO 


-369 (W)(!) 


419 (Z)(3) 


=419 (Z)(#) 


320 (T)(0) 


-320 (T)(SP) 


370 (W)(2) 


-370 (W)(") 


420 (Z)(4) 


-420 (Z)($) 


321 (T)(1) 


-321 (T)(!) 


371 (W)(3) 


-371 (W)(#) 


421 (Z)(5) 


-421 (Z)(%) 


322 (T)(2) 


-322 <T)(") 


372 (W)(4) 


-372 (W)($) 


422 (Z)(6) 


-422 (Z)(&) 


323 (T)(3) 


-323 (T)(#) 


373 (W)(5) 


-373 (W)(%) 


423 (Z)(7) 


-423 (Z)C) 


324 (T)(4) 


-324 (T)($) 


374 (W)(6) 


-374 (W)(&) 


424 (Z)(8) 


-424 (Z)("(") 


325 (T)(5) 


-325 (T)(%) 


375 (W)(7) 


-375 (W)C) 


425 (Z)(9) 


-425 (Z)C>") 


326 (T)(6) 


-326 (T)(&) 


376 (W)(8) 


-376 (W)("(") 


426 (Z)(:) 


-426 (Z)(*) 


327 (T)(7) 


-327 (T)C) 


377 (W)(9) 


-377 (W)(")") 


427 (Z)(;) 


-427 (Z)(+) 


328 (T)(8) 


-328 (T) ("(") 


378 (W)(:) 


-378 (W)(«) 


428 (Z)(<) 


-428 (Z)(,) 


329 (T)(9) 


-329 (T)(")") 


379 (W)(;) 


-379 (W)(+) 


429 (Z)(=) 


-429 (ZX-) 


330 (T)(:) 


-330 (T)(*) 


380 (W)(<) 


-380 (W)(,) 


430 (Z)(>) 


-430 (Z)(.) 


331 (T)(;) 


-331 (T)(+) 


381 (W)(=) 


-381 (W)(-) 


431 (Z)(?) 


-431 (Z)(/) 


332 (T)«) 


-332 (T)(.) 


382 (W)(>) 


-382 (WM.i 


432 (D(0) 


—432 (D(SP) 


333 (T)(=) 


-333 CTH-) 


383 (W)(?) 


-383 (W)(/) 


433 (D(D 


-433 (DID 


334 (T)(>) 


-334 (T)(.) 


384 (X)(0) 


-384 (X)(SP) 


434 (D(2) 


-434 (DC) 


335 (T)(?) 


-335 (DM 


385 (X)(1) 


-385 (X)(!) 


435 (D(3) 


-435 (D(#) 


336 (U)(0) 


-336 (UHSP) 


386 (X)(2) 


-386 (X)(") 


436 (0(4) 


-436 (D($) 


337 (U)(1) 


-337 (U)(!) 


387 (X)(3) 


-387 <X)(#) 


437 (D(5) 


-437 (D(%) 


338 (U)(2) 


-338 (U)C) 


388 (X)(4) 


-388 (X)($) 


438 (D(6) 


-438 (D<&) 


339 (U)(3) 


-339 (U)(#) 


389 (X)(5) 


-389 (X)(%) 


439 (D(7) 


-439 (DC) 


340 (U)(4) 


-340 (U)($) 


390 (X)(6) 


-390 (X)(&) 


440 (0(8) 


-440 (D("(") 


341 (UH5) 


-341 (U)(%) 


391 (X)(7) 


-391 (X)C) 


441 (0(9) 


-441 (DC)") 


342 (U)(6) 


-342 (U)(&) 


392 (X)(8) 


-392 (X)("C) 


442 (DO) 


-442 (D(*) 


343 (U)(7) 


-343 (U)C) 


393 (X)(9) 


-393 (X)(")") 


443 (0(;) 


-443 (D(+) 


344 (U)(8) 


-344 (U)("C) 


394 (X)(:) 


-394 (X)W 


444 (0(<) 


-444 (D(.) 


345 (U)(9) 


-345 (U)C')") 


395 (X)(;) 


-395 (X)(+) 


445 (0(=) 


-445 (D(-) 


346 (U)(:) 


-346 (U)(*) 


396 (X)(<) 


-396 (X)(,) 


446 (D(>) 


-446 (D(.) 


347 (U)<;> 


-347 (U)(+) 


397 (X)(=) 


-397 (XM-) 


447 (0(?) 


-447 <D</) 


348 (U)(<) 


-348 (U)(,) 


398 (X)(>) 


-398 (X)(.) 


448 M(0) 


-448 CO(SP) 


349 (U)(=) 


-349 (U)(-) 


399 (X)(?) 


-399 (X)(/) 


449 (U(1) 


-449 Ml) 



41 14 HOST PROGRAMMER'S 



@ 



B-3 



<INT> PARAMETERS 



Table B-1 (Cont) 
REPRESENTING NUMBERS AS < INT> PARAMETERS 



n <lnt : n> 


— n <lnt : — n> 


n <lnt : n> 


— n <int : — n> 


n <lnt:n; -n <int:-n> 


450 (\)<2) 


-450 (\)(") 


500 (_)(4) 


-500 (_)($) 


550 (b)(6) 


-550 (b)(&) 


451 (\)(3) 


-451 (\)(#) 


501 (_)(5) 


-501 (_)(%) 


551 (b)(7) 


-551 (b)C) 


452 M(4) 


-452 C\)($) 


502 (_)(6) 


-502 (_)(&) 


552 (b)(8) 


-552 (b) ("(") 


453 (\)(5) 


-453 MOW 


503 (_)(7) 


-503 (_)(') 


553 (b)(9) 


-553 (b)(")") 


454 (\)(6) 


-454 (\)(&) 


504 (_)(8) 


-504 (_)("(") 


554 (b)(:) 


-554 (b)(*) 


455 (\)(7) 


-455 (\)C) 


505 (_)(9) 


-505 (_)(")") 


555 (b)(;) 


-555 (b)(+) 


456 (\)(8) 


-456 (V)<"(") 


506 (_)(:) 


-506 (_)(*) 


556 (b)(<) 


-556 (b)(,) 


457 C\)(9) 


-457 (\)(")") 


507 (_)(;) 


-507 (_)(+) 


557 (b)(=) 


-557 (b)(-) 


458 (\)(:) 


-458 (\)(«) 


508 (_)(<) 


-508 (_)(,) 


558 (b)(>) 


-558 (b)(.) 


459 C\)(;) 


-459 (\)(+) 


509 (_)(=) 


-509 (_)(-) 


559 (b)(?) 


-559 (b)(/) 


460 (\)(<) 


-460 (\)(,) 


510 (_)(>) 


-510 (_)(.) 


560 (c)(0) 


-560 (cXSP) 


4R1 Mt) 


-4R1 ft)(.) 


511 ( )(?! 


511 ' *'/* 




I-*** / \ /i\ 










— OOl i.Qnu 


462 (\)(>) 


-462 (\)(.) 


512 i'XO) 


-512 0(SP) 


562 (c)(2) 


-562 (c)(") 


463 (\)<?) 


-463 MM 


513 CX1) 


-513 (')(!) 


563 (c)(3) 


-563 (c)(#) 


464 O)(0) 


-464 0)(SP) 


514 0(2) 


-514 on 


564 (c)(4) 


-564 (c)($) 


465 <])(1) 


-465 Q)(!) 


515 0X3) 


-515 (')(#) 


565 (c)(5) 


-565 (c)(%) 


466 0X2) 


-466 0)(") 


516 0(4) 


-516 (')($) 


566 (c)(6) 


-566 (c)(&) 


467 (])<3) 


-467 (])<#) 


517 0(5) 


-517 C)(%) 


567 (c)(7) 


-567 (c)C) 


468 (])(4) 


-468 (])($) 


518 0(6) 


-518 (')(&) 


568 (c)(8) 


-568 (c)("(") 


469 0)(5) 


-469 0)(%) 


519 C)(7) 


-519 O(') 


569 (c)(9) 


-569 <c)(")") 


470 <])(6) 


-470 0)(&) 


520 0(8) 


-520 (')("(") 


570 (c)(:) 


-570 (c)(*) 


471 a)(7) 


-471 0)0 


521 0X9) 


-521 (')(")") 


571 (c)(;) 


-571 (c)(+) 


472 0)(8) 


-472 0)("(") 


522 (')(:) 


-522 OW 


572 (c)(<) 


-572 (c)(.) 


473 0)(9) 


-473 (])<")") 


523 (')(;) 


-523 (')(+) 


573 (c)(=) 


-573 (c)(-) 


474 fl)(:) 


-474 ax*) 


524 (')(<) 


-524 Of,) 


574 (c)(>) 


-574 (c)(.) 


475 <])<;> 


-475 0)(+) 


525 (')(=) 


-525 CX-) 


575 (c)(?) 


-575 (c)(/) 


476 <])«) 


-476 ())(,) 


526 (')(>) 


-526 ex. I 


576 (d)(0) 


-576 (d)(SP) 


477 ax=) 


-477 (])<-) 


527 (')(?) 


-527 (■)(/) 


577 (d)(1) 


-577 (d)(!) 


478 (])(>> 


-478 <])(.) 


528 (a)(0) 


-528 (aXSP) 


578 (d)(2) 


-578 (d)(") 


479 (])(?) 


-479 ax/i 


529 (a)(1) 


-529 (a)(!) 


579 (d)(3) 


-579 (d)(#) 


480 (A)(0) 


-480 (A)(SP) 


530 (a)(2) 


-530 (a)(") 


580 (d)(4) 


-580 (dXS) 


481 (A)(1) 


-481 (A)(!) 


531 (a)(3) 


-531 (a)(#) 


581 (d)(5) 


-581 (d)(%) 


482 (A)(2) 


-482 (AX") 


532 (a)(4) 


-532 (a)($) 


582 (d)(6) 


-582 (d)(4) 


483 (A)(3) 


-483 (A)(#) 


533 (a)(5) 


-533 (a)(%) 


583 (d)(7) 


-583 (d)C) 


484 (A)(4) 


-484 (A)($) 


534 (a)(6) 


-534 (a)(&) 


584 (d)(8) 


-584 <d)("(") 


485 (A)(5) 


-485 (A)(%) 


535 (a)(7) 


-535 (a)C) 


585 (d)(9) 


-585 (d)(")"> 


486 (A)(6) 


-486 (A)(4) 


536 (a)(8) 


-536 (a)("(") 


586 (d)(:) 


-586 (d)(*) 


487 (A)(7) 


-487 (A)C) 


537 (a)(9) 


-537 (a)(")") 


587 (d)(;) 


-587 (d)(+) 


488 (A)(8) 


-488 (A )("(") 


538 (a)(:) 


-538 (a)W 


588 (d)(<) 


-588 (d)(.) 


489 (A)(9) 


-489 (A )(")") 


539 (a)(;) 


-539 (a)(+) 


589 (d)(=) 


-589 (d)(-) 


490 (A)( : ) 


-490 (A)(.) 


540 (a)(<) 


-540 (a)(,) 


590 (d)(>) 


-590 (d)(.) 


491 (A)(;) 


-491 (A)(+) 


541 (a)(=) 


-541 (a)<-> 


591 (d)(?) 


-591 (d)(/) 


492 (A)(<) 


-492 (A)(,) 


542 (a)(>) 


-542 (a)(.) 


592 (e)(0) 


-592 (eXSP) 


493 (A)(=) 


-493 (AX-) 


543 (aX?) 


-543 (a)(/) 


593 (e)(1) 


-593 (e)(!) 


494 (A)(>) 


-494 (AX.) 


544 (b)(0) 


-544 (b)(SP) 


594 (e)(2) 


-594 (e)(") 


495 (A)(?) 


-495 (AX/) 


545 (b)(1) 


-545 (b)(!) 


595 (e)(3) 


-595 (e)(#) 


496 (_)(0) 


-496 (_XSP) 


546 (b)(2) 


-546 (b)(") 


596 (e)(4) 


-596 (e)($) 


497 (_)(1) 


-497 (_)(!) 


547 (b)(3) 


-547 (b)(#) 


597 (e)(5) 


-597 (e)(%) 


498 (_)(2) 


-498 (_)(") 


548 (b)(4) 


-548 (b)($) 


598 (e)(6) 


-598 (e)(&) 


499 (_)(3) 


-499 (_)(#) 


549 (b)(5) 


-549 (b)(%) 


599 (e)(7) 


-599 (e)C) 



B-4 



IW 



4114 HOST PROGRAMMER'S 



< INT> PARAMETERS 



Table B-1 (Cont) 
REPRESENTING NUMBERS AS <INT> PARAMETERS 



n <lnt:n> 


— n 


<int : — n> 


n <lnt:n> 


— n <int : — n> 


n <lnt:n> 


— n <int : — n> 














600 (e)(8) 


-600 


(e)CT) 


650 (h)(:) 


-650 (h)(«) 


700 (k)(<) 


-700 (k)(,) 


601 (e)(9) 


-601 


<e)<")") 


651 (h)(;) 


-651 (h)(+) 


701 (k)(=) 


-701 (k)(-) 


602 (e)(:) 


-602 


<e)(*) 


652 (h)(<) 


-652 (hX.) 


702 (k)(>) 


-702 (k)(.) 


603 (e)(;) 


-603 


(e)(+) 


653 (h)(=) 


-653 (h)(-) 


703 (k)(?) 


-703 (k)(/) 


604 (e)(<) 


-604 


(e)(.) 


654 (h)(>) 


-654 (h)(.) 


704 (l)(0) 


-704 (IXSP) 


605 (e)(=) 


-605 


(e)(-) 


655 (h)(?) 


-655 (h)(/) 


705 (1X1) 


-705 (l)(!) 


606 (e)(>) 


-606 


(e)(.) 


656 (i)(0) 


-656 (iXSP) 


706 (I) (2) 


-706 OX") 


607 (e)(?) 


-607 


(«)(/) 


657 (j)(1) 


-657 !i)(!) 


707 (!) (3) 


—707 (!)(#) 


608 (f)(0) 


-608 


(MSP) 


658 (i)(2) 


-658 (i)(") 


708 (I) (4) 


-708 (l)($) 


609 (f)(1) 


-609 


(f)(!) 


659 (i)(3) 


-659 (i)(#) 


709 (l)(5) 


-709 (l)(%) 


610 (f)(2) 


-610 


<f>(") 


660 (i)(4) 


-660 (i)($) 


710 (0(6) 


-710 (l)(&) 


611 (f)(3) 


-611 


«)<#) 


661 (0(5) 


-661 (i)(%) 


711 (l)(7) 


-711 (DC) 


612 (f)(4) 


-612 


(f)($) 


662 (i)(6) 


-662 (i)(&) 


712 0X8) 


-712 (!)("(") 


613 (f)(6) 


-613 


(f)(%) 


663 (i)(7) 


-663 (DC) 


713 (I) (9) 


-713 OX")") 


R14 (f)(6) 


—614 


(f)(&) 


664 (i)(«) 


_664 (!)("(") 


714 ini\ 


_7-J4 /jW*\ 


615 (f)(7) 


-615 


(f)C) 


665 (i)(9) 


-665 (i)(")") 


715 (IX;) 


-715 (IX+) 


616 (f)(8) 


-616 


(f)("(") 


666 (!)(:) 


-666 (i)H 


716 (!)(<) 


-716 (IX,) 


617 (f)(9) 


-617 


(f)(")"l 


667 (l)(;) 


-667 (i)(+) 


717 (l)(=) 


-717 (IX-) 


618 (f)(:) 


-618 


(f)(*) 


668 (i)(<) 


-668 «)(,) 


718 «)(>) 


-718 (IX.) 


619 <f)(;> 


-619 


(f)(+) 


669 (i)(=) 


-669 0X-) 


719 (IX?) 


-719 (!)(/) 


620 (f)(<) 


-620 


(f)(,) 


670 (i)(>) 


-670 (i)(.) 


720 (m)(0) 


-720 (mXSP) 


621 (f)(=) 


-621 


«><-) 


671 (i)(?) 


-671 (i)(/) 


721 (m)(1) 


-721 (m)(!) 


622 (f)(>) 


-622 


(f)(.) 


672 (JXO) 


-672 OXSP) 


722 (m)(2) 


-722 (m)C') 


623 (f)(?) 


-623 


(f)(/) 


673 (j)(1) 


-673 OX!) 


723 (m)(3) 


-723 (m)(#) 


624 (g)(0) 


-624 


(gXSP) 


674 (j)(2) 


-«74 OX") 


724 (m)(4) 


-724 (m)($) 


625 (g)(1) 


-625 


(g)(!) 


675 (j)(3) 


-675 0X#) 


725 (m)(5) 


-725 (m)(%) 


626 (g)(2) 


-626 


(g)(") 


676 0X4) 


-676 0X$) 


726 (m)(6) 


-726 (m)(&) 


627 (g)(3) 


-627 


(g)(#) 


677 0X5) 


-677 0X%) 


727 (m)(7) 


-727 (m)C) 


628 (g)(4) 


-628 


(g)($) 


678 0X6) 


-678 OX*) 


728 (m)(8) 


-728 (m)("(") 


629 (g)(5) 


-629 


(g)(%) 


679 0X7) 


-679 OX') 


729 (m)(9) 


-729 (m)(")"> 


630 (g)(6) 


-630 


(g)(&) 


680 0X8) 


-680 0>("<") 


730 (n>)(:) 


-730 (m)M 


631 (g)(7) 


-631 


(g)C) 


681 0X9) 


-681 OX")") 


731 (m)(:) 


-731 (m)(+) 


632 (g)(8) 


-632 


(g)("<") 


682 OX:) 


-682 OX*) 


732 (m)(<) 


-732 (m)(,) 


633 (g)(9) 


-633 


(g)C')") 


683 OX;) 


-683 0X+) 


733 (m)(=) 


-733 (m)(-) 


634 (g)(:) 


-634 


(g)(«) 


684 0X<) 


-684 OX.) 


734 (m)(>) 


-734 (m)(.) 


635 (g)(;) 


-635 


(g)(+) 


685 0X=) 


-685 0X-) 


735 (mX?) 


-735 (m)(/) 


636 (g)(<) 


-636 


(g)(.) 


686 0X>) 


-686 OX) 


736 (n)(0) 


-736 (n)(SP) 


637 (g)(=) 


-637 


(g)(-) 


687 OX?) 


-687 0)M 


737 (n)(1) 


-737 (n)(l) 


638 (g)(>) 


-638 


(g)(.) 


688 (kXO) 


-688 (k)(SP) 


738 (n)(2) 


-738 (n)(") 


639 (g)(?) 


-639 


(g)(/) 


689 (10(1 ) 


-689 (k)(!) 


739 (n)(3) 


-739 (n)(#) 


640 (h)(0) 


-640 


(h)(SP) 


690 (k)(2) 


-690 (k)(") 


740 (n)(4) 


-740 (n)($) 


641 (h)(1) 


-641 


(h)(!) 


691 00(3) 


-691 (k)(#) 


741 (n)(5) 


-741 (n)(%) 


642 (h)(2) 


-642 


(h)C') 


692 00(4) 


-692 (k)($) 


742 (n)(6) 


-742 (n)(&) 


643 (h)(3) 


-643 


(h)(#) 


693 (k)(5) 


-693 (k)(%) 


743 (n)(7) 


-743 (n)C) 


644 (h)(4) 


-644 


(h)($) 


694 (k)(6) 


-694 (k)(&) 


744 (n)(8) 


-744 (n)("("> 


645 (h)(5) 


-645 


(h)(%) 


695 (k)(7) 


-695 (IOC) 


745 (n)(9) 


-745 (n)C')") 


646 (h)(6) 


-646 


(h)<&) 


696 (k)(8) 


-696 (k)("(") 


746 (n)(:) 


-746 (n)M 


647 (h)(7) 


-647 


!h)C) 


697 (k)(9) 


-697 (k)(T) 


747 (n)(;) 


-747 (n)(+) 


648 (h)(8) 


-648 


(h)("("> 


698 (k)(:) 


-698 (MM 


748 (n)(<) 


-748 (n)(,) 


649 (h)(9) 


-649 


(h)(")"» 


699 (k)(;) 


-699 00(+) 


749 (n)(=) 


-749 (n)(-) 
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@ 



B-5 



< INT> PARAMETERS 



Table B-1 (Cont) 
REPRESENTING NUMBERS AS <INT> PARAMETERS 



n <int:n> 


— n 


<int : -n> 


n 


<int : n> 


— n <int : — n> 


n 


<lnt : n> 


— n 


<lnt : -n> 


750 (n)(>) 


-750 


(n)(.) 


800 


(f)(0) 


-800 (r)(SP) 


850 


(u)(2) 


-850 


<u)(") 


751 (n)(?) 


-751 


(n)M 


801 


(f)(1) 


-801 (r)(!) 


851 


(u)(3) 


-851 


(u)(#) 


752 (o)(0) 


-752 


(oHSP) 


802 


(f)(2) 


-802 (r)(") 


852 


(u)(4) 


-852 


(u)($) 


753 (o)(1) 


-753 


(o)(!) 


803 


(f)(3) 


-803 (r)(#) 


853 


(u)(5) 


-853 


(u)(%) 


754 (o)(2) 


-754 


<o)C) 


804 


(f)(4) 


-804 (r)($) 


854 


(u)(6) 


-854 


(u)(&) 


755 (o)(3) 


-755 


(o)<#) 


805 


(f)(5) 


-805 (r)(%) 


855 


(u)(7) 


-855 


(u)C) 


756 (o)(4) 


-756 


(o)($) 


806 


(f)(6) 


-806 (r)(&) 


856 


(u)(8) 


-856 


(u)("(") 


757 (o)(5) 


-757 


(o)(%) 


807 


(f)(7) 


-807 (r)C) 


857 


(u)(9) 


-857 


(u)(")") 


758 (0)(6) 


-758 


(o)<&) 


808 


(f)(8) 


-808 (r)("(") 


858 


(u)(:) 


-858 


(u)(«) 


759 (o)(7) 


-759 


(o)C) 


809 


(f)(9) 


-809 (r)(")") 


859 


(u)(;) 


-859 


(u)(+) 


760 (o)(8) 


-760 


!o)("!") 


810 


(r)(:> 


—810 (r}(«! 


860 


u)(<) 


-860 


(u)(.) 


761 (o)(9) 


-761 


(o)(")") 


811 


(f)(;) 


-811 <r)<+) 


861 


(u)(=) 


-861 


(u)(-) 


762 (o)(:) 


-762 


(o)<*) 


812 


<r)<<) 


-812 (r)(,) 


862 


(u)(>) 


-862 


(u)(.) 


763 (o)(;) 


-763 


(o){+) 


813 


(r)(=) 


-813 (r)(-) 


863 


(u)(?) 


-863 


(u)(/) 


764 (o)(<) 


-764 


(o)(.) 


814 


(r)(>) 


-814 (r)(.) 


864 


(v)(0) 


-864 


(v)(SP) 


765 (o)(=) 


-765 


(o)(-) 


815 


(r)(?) 


-815 (r)(/) 


865 


iv)(1) 


-865 


(v)(!) 


766 (0)(>) 


-766 


(o)(.) 


816 


(s)(0) 


-816 (s)(SP) 


866 


(v)(2) 


-866 


(v)(") 


767 (o)(?) 


-767 


(o)(/) 


817 


(s)(1) 


-817 (s)(!) 


867 


!v)(3) 


-867 


(v)(#) 


768 (p)(0) 


-768 


(pMSP) 


818 


(s)(2) 


-818 (s)!") 


868 


(v)(4) 


-868 


(v)($) 


769 (p)(1) 


-769 


(p)(!) 


819 


(s)(3) 


-819 (s)(#) 


869 


!v)(5) 


-869 


(v)(%) 


770 (p)(2) 


-770 


(p)("> 


820 


(s)(4) 


-820 (s)($) 


870 


v)(6) 


-870 


(v)(&) 


771 (p)(3) 


-771 


(p)(#) 


821 


(s)(5) 


-821 (s)(%) 


871 


v)(7) 


-871 


wo 


772 (p)(4) 


-772 


(p)($) 


822 


(s)(6) 


-822 (s)(4) 


872 


v)(8) 


-872 


(v) ("(") 


773 (p)(5) 


-773 


(p)(%) 


823 


(s)(7) 


-823 (s)O 


873 


v)(9) 


-873 


(v)(")"l 


774 (p)(6) 


-774 


(P)(&) 


824 


(s)(8) 


-824 (s)("(") 


874 


v)(:) 


-874 


(v)(*) 


775 (p)(7) 


-775 


(p)C) 


825 


(s)(9) 


-825 <s)(")"> 


875 


v)(;) 


-875 


(v)(+) 


776 (p)(8) 


-776 


<p)("<"> 


826 


(s)(:) 


-826 (s)(*l 


876 


(v)(<) 


-876 


(v)(.) 


777 (p)(9) 


-777 


(p)(")"l 


827 


(s)(;) 


-827 (s)(+) 


877 


v)(=) 


-877 


!v)(-) 


778 (p)(:) 


-778 


(p)(*> 


828 


(s)(<) 


-828 (s)(,) 


878 


(v)(>) 


-878 


(v)(.) 


779 (p)(;) 


-779 


»P)(+) 


829 


(s)(=) 


-829 (s)(-) 


879 


v)(7) 


-879 


(v)(/) 


780 (p)(<) 


-780 


(p)(,) 


830 


(s)(>) 


-830 (s)(.) 


880 


w)(0) 


-880 


(w)(SP) 


781 (p)(=) 


-781 


(p)(-) 


831 


(s)(?) 


-831 (s)(/) 


881 


w)(1) 


-881 


(w)(!) 


782 (p)(>) 


-782 


(p)(.) 


832 


(t)(0) 


-832 (t)(SP) 


882 


w)(2) 


-882 


w)(") 


783 (p)(?) 


-783 


(p)</) 


833 


(t)(1) 


-833 (t)(!) 


883 


w)(3) 


-883 


w)(#) 


784 (q)(0) 


-784 


(q)(SP) 


834 


(t)(2) 


-834 (t)(") 


884 


w)(4) 


-884 


w)($) 


785 (q)(1) 


-785 


(q)(!) 


835 


(t)(3) 


-835 (t)(#) 


885 


w)(5) 


-885 


(w)(%) 


786 (q)(2) 


-786 


(q)(") 


836 


(f)(4) 


-836 (t)($) 


886 


w)(6) 


-886 


lw)(&) 


787 (q)(3) 


-787 


(q)(#) 


837 


(t)(5) 


-837 (t)(%) 


887 


w)(7) 


-887 


(w)C) 


788 (q)(4) 


-788 


(q)($) 


838 


(t)(6) 


-838 (t)(&) 


888 


w)(8) 


-888 


w)("(") 


789 (q)(5) 


-789 


(q)(%) 


839 


(t)(7) 


-839 (O(') 


889 


w)(9) 


-889 


w)(")") 


790 (q)(6) 


-790 


(q)(&) 


840 


(f)(8) 


-840 (t) ("(") 


690 


w)(:) 


-890 


w)(.) 


791 (q)(7) 


-791 


(q)C) 


841 


(f)(9) 


-841 «)(")") 


891 


w)(;) 


-891 


w)(+) 


792 (q)(8) 


-792 


<q)<"<") 


842 


(«(:) 


-842 (t)(«) 


892 


(w)(<) 


-892 


(w)(,) 


793 (q)(9) 


-793 


<q)(T) 


843 


(t)(;) 


-843 (t)(+) 


893 


w)(=) 


-893 


w)(-) 


794 (q)(:) 


-794 


<q)<*) 


844 


(t)(<) 


-844 (t)(,) 


894 


w)(>) 


-894 


w)(.) 


795 (q)(;) 


-795 


(q)(+) 


845 


(t)(=) 


-845 (t)(-) 


895 


w)(?) 


-895 


w)(/) 


796 (q)(<) 


-796 


(q)(.) 


846 


(t)(>) 


-846 (t)(.) 


896 


x)(0) 


-896 


x)(SP) 


797 (q)(=) 


-797 


(q)(-) 


847 


(t)(?) 


-847 (t)(/) 


897 


x)(1) 


-897 


x)(!) 


798 (q)(>) 


-798 


(q)(.) 


848 


(u)(0) 


-848 (u)(SP) 


898 


x)(2) 


-898 


x)(") 


799 (q)(?) 


-799 


(q)(/) 


849 


(u)(1) 


-849 (u)(!) 


899 


x)(3) 


-899 


x)(#) 
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Table B-1 (Cont) 
REPRESENTING NUMBERS AS <INT> PARAMETERS 



n <lnt : n> 


— n 


<int : -n> 


n 


<int : n> 


— n 


<int : — n> 


n 


<int : n> 


— n 


<int : — n> 


900 (x)(4) 


-900 


(x)($) 


950 


(0(6) 


-950 


((>(&) 


1000 


(~)(8) 


-1000 


(-)("(") 


901 (x)(5) 


-901 


(x)(%) 


951 


(0(7) 


-951 


(OC) 


1001 


<-)(9) 


-1001 


(-)(")") 


902 (x)(6) 


-902 


(x)(&) 


952 


(0(8) 


-952 


(Dm 


1002 


<-)(:) 


-1002 


(-)(•) 


903 (x)(7) 


-903 


(x)C) 


953 


(0(9) 


-953 


(DC)") 


1003 


(-)(;) 


-1003 


<-)<+) 


904 (x)(8) 


-904 


W("(") 


954 


(()(:) 


-954 


(()<•> 


1004 


(-)(<) 


-1004 


<-)(,) 


905 (x)(9) 


-905 


(x)C)") 


955 


(()(;) 


-955 


(()(+) 


1005 


(->(=) 


-1005 


<-)<-) 


906 (x)(:) 


-906 


(x)M 


956 


(()(<) 


-956 


(()(,) 


1006 


(-)<>) 


-1006 


(-)(.) 


907 (x)(;) 


-907 


(x)(+) 


957 


([)(=) 


—957 


(!)(-) 


1007 


(~)(?) 


— 1007 


(~)M 


908 (xX<) 


-908 


(x)(,) 


958 


<!)(>) 


-958 


(in.) 


1008 


(DELXO) 


-1008 


(DEU(SP) 


909 (x)(=) 


-909 


(x)(-) 


959 


<{)(?) 


-959 


(DM 


1009 


(DELX1) 


-1009 


(DELX!) 


910 (x)(>) 


-910 


(x)(.) 


960 


(|)(0) 


-960 


(|)(SP) 


1010 


(DELX2) 


-1010 


(DEL)C) 


911 (x)(?) 


-911 


MM 


961 


(|)(1) 


-961 


(!)(!) 


1011 


(DEL) (3) 


-1011 


(DELX*) 


912 (y)(0) 


-912 


(y)(SP) 


962 


(|)(2) 


-962 


(|)<") 


1012 


(DEL) (4) 


-1012 


(DEL)($) 


913 (y)(1) 


-913 


(y)(!) 


963 


(|)(3) 


-963 


(|)(#) 


1013 


(DELX5) 


-1013 


(DEL)(%) 


914 (y)(2) 


—914 


(y)(") 


964 




—964 


(IMS) 


1014 


(DEL) (6! 


— 1014 


(DELX&) 


915 (y)(3) 


-915 


(y)(#) 


965 


(|)(5) 


-965 


(|)(%) 


1015 


(DELX7) 


-1015 


(DEL)C) 


SI 6 (y)(4) 


-918 


<y)($) 


968 


(D(6) 


—968 


d)(&) 


1016 


(DEL) (8) 


-1016 


(DEL) ("(") 


917 (y)(5) 


-917 


(y)(%) 


967 


(|)(7) 


-967 


(|>C) 


1017 


(DELX9) 


-1017 


(DEL)C)") 


918 (y)(6) 


-918 


<y>(&) 


968 


(|)(8) 


-968 


(pen 


1018 


(DELX:) 


-1018 


(DELX*) 


919 (y>(7) 


-919 


(y)C) 


969 


(|)(9) 


-969 


(|)C)") 


' 1019 


(DELX;) 


-1019 


(DELX+) 


920 (y)(8) 


-920 


(y)("(") 


970 


(D(:) 


-970 


(DM 


1020 


(DEL)(<) 


-1020 


(DELX,) 


921 (y)(9) 


-921 


(y)(")") 


971 


(|)(;) 


-971 


(D<+) 


1021 


(DELX=) 


-1021 


(DEU(-) 


922 (y)(:) 


-922 


<y)M 


972 


(l)(<) 


-972 


(|)(.) 


1022 


(DEL)(>) 


-1022 


(DELX.) 


923 (y)(;) 


-923 


(y)(+) 


973 


(l)(=) 


-973 


(p(-) 


1023 


(DEL)(?) 


-1023 


(DEL)M 


924 (y)(<) 


-924 


(y)(.) 


974 


(l)(>) 


-974 


(p(.) 


1024 


(A)(@)(0) 


-1024 


(AX@)(SP) 


925 (y)(=) 


-925 


(y)(-) 


975 


(l)(?) 


-975 


(DM 


1025 


(A)(@X1) 


-1025 


(A)(@)(!) 


926 (y)(>) 


-926 


(y)(.) 


976 


(I)(0) 


-976 


(})(SP) 


1026 


(A)(@)(2) 


-1026 


(A)(@)(") 


927 (y)(?) 


-927 


(y)(/) 


977 


())(1) 


-977 


(})(!) 


1027 


<AK@)(3) 


-1027 


(AX@)(#) 


928 (z)(0) 


-928 


(z)(SP) 


978 


(I) (2) 


-978 


(DC) 


1028 


(A)(@)(4) 


-1028 


(A)(@)($) 


929 (z)(1) 


-929 


(z)(!) 


979 


())(3) 


-979 


())(#) 


1029 


(A)(@X5) 


-1029 


(A)(@X%) 


930 (z)(2) 


-930 


(z)(") 


980 


(I) (4) 


-980 


())($) 


1030 


(A)<@)(6) 


-1030 


(A)(@)(&) 


931 (z)(3) 


-931 


(z)(#) 


981 


())(5) 


-981 


())(%) 


1031 


(A)(@)(7) 


-1031 


(AX@)C) 


932 (z)(4) 


-932 


(z)($) 


982 


())(6) 


-982 


()>(&) 


1032 


(A)(@)(8) 


-1032 


<A)(@)C(") 


933 (z)(5) 


-933 


(z)(%) 


983 


())(7) 


-983 


(DC) 


1033 


(A)(@)(9) 


-1033 


(A)(l@)C)") 


934 (z)(6) 


-934 


(z)(&) 


984 


0X8) 


-984 


(})(•■(■■) 


1034 


(AX@X:) 


-1034 


(A) «©)(♦) 


935 (z)(7) 


-935 


(z)C) 


985 


())(9) 


-985 


(DC)") 


1035 


(A)(@)(;) 


-1035 


(A)(@)(+) 


936 (z)(8) 


-936 


(z)("(") 


986 


())(:) 


-986 


())<•) 


1036 


(A)(@)«) 


-1036 


(A)«@X,) 


937 (z)(9) 


-937 


(z)C)") 


987 


())(;) 


-987 


())(+) 


1037 


(A)<@)(=) 


-1037 


(A)«@X-) 


938 (z)(:) 


-938 


(z)(.) 


988 


())(<) 


-988 


OX,) 


1038 


(A){@)(>) 


-1038 


(A)«@)(.) 


939 (z)(;) 


-939 


(z)(+) 


989 


())(=) 


-989 


())(-) 


1039 


(AX@)(?) 


-1039 


(AX@)(/) 


940 (z)(<) 


-940 


(z)(.) 


990 


())(>) 


-990 


())(.) 


1040 


(A) (A)(0) 


= 1040 


(A)(A)(SP) 


941 (z)(=) 


-941 


(z)(-) 


991 


())(?) 


-991 


(DM 


1041 


(A) (A)(1) 


-1041 


(AXAX!) 


942 (z)(>) 


-942 


(z)(.) 


992 


(~)(0) 


-992 


<~)(SP) 


1042 


(A) (A)(2) 


-1042 


(A)(A)C) 


943 (z)(?) 


-943 


(z)(/) 


993 


<-)(1) 


-993 


(~X!) 


1043 


(A) (A)(3) 


-1043 


(AXA)(#) 


944 (0(0) 


-944 


(0(SP) 


994 


(~)(2) 


-994 


(~)C) 


1044 


(A) (A)(4) 


-1044 


(AXA)($) 


945 (0(1) 


-945 


(0(!) 


995 


(~)(3) 


-995 


(~)(#) 


1045 


(A) (A)(5) 


-1045 


(A)(A)(%) 


946 (0(2) 


-946 


(DC) 


996 


(~)(4) 


-996 


<-)($) 


1046 


(AXAX6) 


-1046 


(AXAX4) 


947 (0(3) 


-947 


(!)(#) 


997 


!~)(5) 


-997 


!-)(%) 


1047 


(A)(A)(7) 


-1047 


(A)(A)C) 


948 (0(4) 


-948 


({)($) 


998 


<~)(6) 


-998 


(-)(&) 


1048 


(AXAX8) 


-1048 


(AXAXT) 


949 (0(5) 


-949 


(0(%) 


999 


(~)(7) 


-999 


(~)C) 


1049 


(AXAX9) 


-1049 


(AXAX")") 
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Appendix C 
EXAMPLES OF CODE 



This appendix contains two examples of host computer The second example is a collection of FORTRAN 
code used to control the 41 1 4 terminal. subprograms which were used to test the terminal's 

block mode communications protocol. 
The first example is a PASCAL program which does 
graphic input using the thumbwheels and locator 
function. It includes PASCAL device driver routines to 
issue a variety of commands to the terminal. 
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EXAMPLES OF CODE 



A PASCAL GRAPHIC INPUT PROGRAM 



13_May-81 



TEK Pascal v3.00 



10 
20 
30 
40 
50 
60 
70 
80 

1 00 
110 
120 
130 
140 
150 
160 
170 
180 
190 
200 
210 
220 
230 
240 
250 
260 
270 
280 
290 
300 
310 
320 
330 
340 
350 
360 
370 
380 
390 
400 
410 
420 
430 
440 
450 
460 



PROGRAM Example; 

{XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXKXXXXXXXXKXXXXXXXXKXXX 

* This program shows how to do graphic input with the thumbwheels * 

* device and locator function. * 

* The program also shows how device driver routines might be * 

* written in PASCAL. * 

* The PASCAL dialect used has the following peculiarities: * 

* (a) the native character set is ASCII; thus Chr(65) = 'A'. * 

* (b) the special file identifier TTY refers to the user's terminal. * 

»*X**X*XXS*S*X»X*S*XX*XX*KSX»*XX»SS**X*X»**»X*»XXXS£«»»»»«»#«»»*X**#***] 

CONST 

{** Mnemonic names for ASCII decimal equivalents **} 



Esc = 27; Us 

LetterA = 65 

LetterE = 69 

Letterl = 73 

LetterM = 77 

LetterQ = 81 

LetterU = 85 

LetterY = 89 



= 31; Gs 
LetterB 
LetterF 
Letter J 
LetterN 
LetterR 
LetterV 
LetterZ 



29 
66 
70 
74 
78 
82 
86 
90 



Fs = 28; 

LetterC = 67 

LetterG = 71 

LetterK = 75 

LetterO = 79 

Letters = 83 

LetterW = 87 



LetterD 
LetterH 
LetterL 
LetterP 
LetterT 
LetterX 



68 
72 
76 
80 
84 



TYPE 

{XX 



Data types used by I/O routines **} 

TwelveBitType = 0..4095; 
SevenBitType = 0..127; 
IntType = -32768. .+32767; 
CharType = ' '..'"*; 

{** IntArrays are linked lists of IntRecords **} 
IntRecordPtrType = "IntRecordType ; 
IntRecordType = RECORD 

Item : IntType; 

Next : IntRecordPtrType; 

END; 
IntArrayType = RECORD 

Count : IntType; 

First : IntRecordPtrType; 

END; 

XyType = RECORD 

X : TwelveBitType; 
Y : TwelveBitType; 

END; 
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470 
480 
490 
500 
510 
520 
530 
540 
550 
560 
570 
580 
590 
600 
610 
620 
630 
640 
650 
660 
670 
680 
690 
700 
710 
720 
730 
740 
750 
760 
770 
780 
790 

800 

8m 

820 

830 

840 

850 

860 

870 

880 

890 

900 

910 

920 

930 

940 

950 

960 

970 

980 

990 

1000 

1010 

1020 

1030 

1040 



VAR 



{** Variables used by I/O routines **} 
{** Used by SendXy »»} 

OldHiY, OldExtra, OldLoY, OldHiX : 0. . 127; 

HaveSentXY : BOOLEAN; 
{** Used by ReceiveAscii **} 

End Of Line : BOOLEAN; 

{** Variables used by the mainline. **} 
Xy : XyType; 

IntArray : IntArrayType ; 
SignatureChar , KeyChar : CHAR; 



{** Data structure manipulation routines : IntArrayType variables **} 

PROCEDURE InitializeNewIntArray(VAR IntArray : IntArrayType); {}{}{}{}{ 
"} BEGIN" 

} IntArray. Count := 0; 

} IntArray .First := NIL 

} END; 

}{}{}{}{}{}{}{}{}{}{){}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{} 

PROCEDURE Clear IntArray(VAR IntArray : IntArrayType); {}{}{}{}{}{}{}{} 

} VAR 

} Pointer : IntRecordPtrType ; 

} BEGIN 

} IF (IntArray. Count > 0) 
} THEN BEGIN 

} IF (IntArray. First". Next = NIL) 

} THEN BEGIN 

} DisposedntArray. First) ; 

} IntArray. First := NIL; 

} IntArray .Count := 

} ELSE 

} BEGIN 

} Pointer := IntArray .First ; 

} WHILE NOT (Pointer' .Next* .Next = NIL) 

} DO Pointer := Pointer" .Next ; 

} Dispose(Pointer" .Next) ; 

} Pointer" .Next := NIL; 

} IntArray. Count := IntArray . Count - 1; 

} Clear IntArray(IntArray) 

} END 

} END; 

} END; 

}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{} 

PROCEDURE GetNewIntRecordAndLoadIt(VAR Pointer : IntRecordPtrType; 
} Int : IntType);{}{}{}{}{}{}{}{}{}{} 

} BEGIN 

} New(Pointer) ; 

} Pointer" .Item := Int; { 

} Pointer" .Next := NIL { 

} END; 
}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}(}{}{}{} 
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1050 
1060 
1070 
1080 
1090 
1100 
1110 
1120 
1130 
1140 
1150 
1160 
1 170 
1180 
1190 
1200 
1210 
1220 
1230 
1240 
1250 
1260 
1270 
1280 
1290 
1300 
1310 
1320 
1330 
1340 
1350 
1360 
1370 
1380 
1390 
1400 
1410 
1420 
1430 
1440 
1450 
1460 
1470 
1480 
1490 
1500 
1510 
1520 
1530 
1540 
1550 
1560 
1570 
1580 
1590 
1600 
1610 



PROCEDURE AppendToIntArray(VAR IntArray : IntArrayType ; 

Int : IntType);{}{}{}{}{}{}{}{}{}{}{}{}{}{}{ 
VAR 

Pointer : IntRecordPtrType ; 

BEGIN 

IF (IntArray .Count = 0) 

THEN BEGIN 

Ge t Ne win t Record And Load It (Int Array .First , Int) ; 

IntArray . Count := IntArray . Count + 1 

END 
ELSE IF (IntArray. Count > 0) 

THEN BEGIN 

Pointer := IntArray .Fir st ; 

WHILE NOT (Pointer' .Next = NIL) 
DO Pointer := Pointer" .Next ; 

Ge t Ne win t Record And Load It (Pointer" .Next , Int) ; 

IntArray . Count :r IntArray . Count + 1 

END; 
END; 
{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{} 



{** Routines for output from host to 41 1X terminal **} 

PROCEDURE SendASCIKCharCode : SevenBitType) ; {}{}{}{}{}{}{}{}{}{}{}{} 
'} BEGIN 

} Write(TTY,Chr(CharCode)) ; 

} END; 

}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{} 

PROCEDURE SendXYUY : XYType) ;{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{ } 
r } 

} TYPE 

} FiveBitType = 0.-31; 

} TwoBitType = 0. .3; 

} 

} VAR 

} HiFiveX, HiFiveY, MidFiveX, MidFiveY : FiveBitType; 

} LoTwoX, LoTwoY : TwoBitType; 

} HiY, Extra, LoY, HiX, LoX : 0. . 127; 

} GottaSendExtraByte , GottaSendLoYByte , 

} GottaSendHiXByte : BOOLEAN; 

} 

} PROCEDURE Split( Coordinate : TwelveBitType ; 



VAR HighFiveBits : FiveBitType; 

VAR MiddleFiveBits : FiveBitType; 

VAR LowTwoBits : TwoBitType); {}{}{}{}{}{}{}{}{}{}{}{} 

BEGIN 

HighFiveBits := Coordinate DIV 128; 

MiddleFiveBits := (Coordinate MOD 128) DIV 4; 

LowTwoBits := Coordinate MOD 4; 

END; 

{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{} 



C4 
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1620 
1630 
1640 
1650 
1660 
1670 
1680 
1690 
1700 
1710 
1720 
1730 
1740 
1750 
1760 
1770 
1780 

1 7nn 

1800 
1 R1 n 

■ \j i \j 

1820 
1830 
1840 
1850 
1860 
1870 
1880 
1890 
1900 
1910 
1920 
1930 
194 
1950 
1960 
1970 
1980 
1990 
2000 
2010 
2020 
2030 
2040 
2050 
2060 
2070 
2080 
2090 



BEGIN 

{** Partition the X- and 

Split(XY.X, HiFiveX, MidFiveX, 
SplitCXY.Y, HiFiveY, MidFiveY, 

{** Compute all five bytes of the 



coordinates into 5- : 
LoTwoX); 
LoTwoY); 
<xy> paramter 



5-, 2-bit fields"} 



KX } 



HiY : 
Extra 
LoY : 
HiX : 
LoX : 
{** Send 



= HiFiveY + 32; 

:= 4 * LoTwoY + LoTwoX + 96 
: MidFiveY + 96; 
: HiFiveX + 32; 
: MidFiveX + 64; 

only those bytes 



which are needed **} 



IF 



NOT HaveSentXY 
THEN 

BEGIN 

SendASCII(HiY); OldHiY := HiY; 

SendASCII(Extra) ; OldExtra := Extra 



OldLoY 
m Hm y 



SendASCII(LoY) 

SendASCII(LoX) 
HaveSentXY := TRUE; 
END 
ELSE {** IF HaveSentXY **} 
BEGIN 
IF (HiY <> OldHiY) 

THEN BEGIN 

SendASCII(HiY); OldHiY 

END; 
Gotta Send Extra Byte 
GottaSendHiXByte : 
GottaSendLoYByte : 



= LoY; 

- H-i Y- 



HiY; 



= (Extra <> OldExtra) ; 
(HiX <> OldHiX); 
(LoY <> OldLoY) 
OR GottaSendExtraByte 
OR GottaSendHiXByte; 
IF GottaSendExtraByte 
THEN BEGIN 

SendASCIKExtra) : OldExtra := Extra: 
END; 
IF GottaSendLoYByte 
THEN BEGIN 

SendASCII(LoY); OldLoY := LoY; 
END; 
IF GottaSendHiXByte 
THEN BEGIN 

SendASCII(HiX); OldHiX := HiX; 
END; 
SendASCII(LoX); 
END; 
END; 
{XHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHH} 
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2100 
2110 
2120 
2130 
2140 
2150 
2160 
2170 
2180 
2190 
2200 
2210 
2220 
2230 
2240 
2250 
2260 
2270 
2280 
2290 
2300 
2310 
2320 
2330 
23^0 
2350 
2360 
2370 
2380 
2390 
2400 
2410 



PROCEDURE SendlntQ : IntType) ; 



Encodes I as a sequence of bytes in the <packed-integer> 
format and sends those bytes to the terminal. 

Calls the Send ASCII procedure; also uses the following 
globally-declared data types: 



TYPE 



SevenBitType 



127; 



********K**##)f#»)f#*****»***K#**#*##9(**K#*K#**#**#»#**#*K#***#K###)S#»)t* 



CONST 

MaxNumber Bytes 



VAR 



3; {*** I should be in the range from } 
{ -32768 to +32767, so no more than } 
{ three bytes are needed. ***} 



StackPointer, J : 0. .MaxNumber Bytes; 

Stack : ARRAY[ 1 .. MaxNumber Bytes] OF SevenBitType; 

Hil : 64. .127; 

Lol : 32.. 63; 

Negative : BOOLEAN; 

PROCEDURE Push(Byte : SevenBitType); {*« Push byte on stack *»} 
rl {}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{ }{}{}{}"- 

BEGIN 

StackPointer := StackPointer + 1; 

Stack[StackPointer] := Byte 

END; 

{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{} 
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2420 
2430 
2440 
2450 
2460 
2470 
2480 
2490 
2500 
2510 
2520 
2530 
2540 
2550 
2560 
2570 
2580 
2590 

2610 
2620 
2630 
2640 
2650 
2660 
2670 
2680 
2690 
2700 
2710 
2720 
2730 
2740 
2750 
2760 
2770 
2780 



BEGIN 



{*** statement-part of Sendlnt procedure ***} 



{*** Initialize things. ***} 
StackPointer := 0; 
Negative := FALSE; 

{*** Compute bytes, push them onto the stack. ***} 
IF I < 

THEN BEGIN 
I := -I; 

Negative := TRUE; 
END; 

{*** Compute Lol byte, push it on the stack. ***} 

{*** <LoI> : binary Olsdddd; s = sign bit, d = data bit.***} 

{*** s=1 for positive numbers, s=0 for negative numbers. **} 
Lol := I MOD 16 + 32; 






1 c . 
IV, 



Push(LoI) ; 

± ; = x ui. \l i o ; 

{*** Compute Hil bytes, push them on stack. ***} 
{*** <HiI> : binary Iddddd. ***} 
WHILE I > 

DO BEGIN 

Hil := (I MOD 64) + 64; 

Push(Hil); 

I := I DIV 64 

END; 

{*** Pop bytes off stack and send them to the terminal 
FOR J := StackPointer DOWNTO 1 
DO SendASCII(Stack[J]) 



*x* } 



s \ 

I. J 



! \ 



£wn- {#»« f Sendlnt procedure ***} 
{}{}{}{}{}{}{}{}{}{}{}U{ }{}{•}{}{}{ }{}{}{}{}{}{}{}{}{}{}{}{}{}{}{ }{}{}{} 
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2790 

2800 

2810 

2820 

2830 

2840 

2850 

2860 

2870 

2880 

2890 

2900 

2910 

2920 

2930 

29^0 

2950 

2960 

2970 

2980 

2990 

3000 

3010 

3020 

3030 

3040 

3050 

3060 

3070 

3080 

3090 

3100 

3110 

3120 

3130 

3140 

3150 

3160 

3170 

3180 

3190 

3200 

3210 



PROCEDURE SendlntArrayUntArray : IntArrayType) ;{}{}{}{}{}{}{}{}{}{}{ } 

VAR 

I : IntType; 

Pointer : IntRecordPtrType ; 

BEGIN 

Send Int(Int Array. Co un t) ; 

IF (IntArray. Count > 0) THEN 

BEGIN {** Find the <int>s in the linked list, send 'em off.**} 
Pointer := IntArray .Fir st ; 
FOR I := 1 TO IntArray. Count DO 
BEGIN 

SendInt(Pointer" .Item) ; 
Pointer := Pointer^ . Next 
END; 
END; 
END; 
.{}{>{}{>{}{}{}{>{}{}{}{}{}{}{}{}{>{}{}{ HlUUUtHHHHHHHHH} 
** 41 1 X I/O routines ... for input to host from 411X terminal **} 

ROCEDURE ReceiveAscii(VAR Character Code : SevenBitType) ; UUUUOO 



VAR 

Ch : CHAR; 

BEGIN 

IF Eoln(TTY) 
THEN 

BEGIN 

CharacterCode := 13; {*• (CR) **} 
Readln(TTY) 
END 
ELSE {** IF NOT Eoln(TTY) **} 
BEGIN 

Read(TTY,Ch) ; 
CharacterCode := Ord(Ch) 
END; 
END; 
{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{){}{}{}{}{}{}{}{} 
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3220 
3230 
3240 
3250 
3260 
3270 
3280 
3290 
3300 
3310 
3320 

3340 
3350 
3360 
3370 
3380 
3390 
3400 
3410 
3420 
3430 
3440 
3450 
3460 
3470 
3480 
3490 
3500 
3510 
3520 
3530 
3540 
3550 
3560 

J-/ I «-• 

3580 
3590 
3600 
3610 
3620 
3630 
3640 
3650 
3660 
3670 
3680 
3690 



PROCEDURE ParseAnXyF.eport(VAR Xy : XyType) ; {}{}{}{}{}{}{}{}{}{}{}{}{} 

VAR 

HiYReport , Extra Report ,LoYRe port , Hi XRe port , 

LoXReport : SevenBitType ; 
X, Y : TwelveBitType; 

PROCEDURE SkipPastIrrelevantCharacters(VAR Ch : SevenBitType) ;{}{ } 

{} BEGIN {} 

{} ReceiveAscii(Ch) ; {} 

{} WHILE ((Ch < 32) OR (Ch > 63) ) DO {} 

I 1 Ran o-iuafleni t ( CV\ \ • I \ 

{} END; {} 

{}{}{}{}{}{}{}.{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{} 

BEGIN 

{** grab the five characters **} 

Ski pPa stir relevant Characters (HiYReport) ; 

SkipPastlrrelevantCharacters(ExtraReport) ; 

Sk i pPa st Ir r el ev ant Char acters(LoYRe port) ; 

SkipPastlrrelevantCharacters(HiXReport) ; 

Ski pPa st Ir r el ev ant Char acters( LoXReport) ; 
{** Compute the x- and y-coordinates **} 

X := 32*(HiXReport - 32) + (LoXReport - 32); 

X := 4*X + (ExtraReport MOD 4); 

Y := 32*(HiYReport - 32) + (LoYReport - 32); 

Y := 4*Y + (ExtraReport DIV 4) MOD 4; 
Xy.X := X; 
Xy.Y := Y; 

END; 
{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{} 

ROCEDURE ParseAGinLocatorReport(VAR Key : CHAR; 

VAR Xy : XyType) ;{}{}{}{}{}{}{}{}{}{ } 

T7AD 
v n i\ 

AsciiDecimalEquivalent : SevenBitType; 

BEGIN 

{** Parse the <ASCII-char : "key"> **} 

ReceiveASC II (AsciiDecimalEquivalent) ; 

Key := Chr( AsciiDecimalEquivalent) ; 
{** Parse the <xy-report : "cursor-position"> 

Pa r se An Xy Re po r t ( Xy ) 
END; 
{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}(}{} 
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3700 
3710 
3720 
3730 
3740 
3750 
3760 
3770 
3780 
3790 
3800 
3810 
3820 
3830 
?Ri»0 
3850 
3860 
3870 
3880 
3890 
3900 
3910 
3920 
3930 
39*»0 
3950 
3960 
3970 
3980 
3990 
4000 
4010 
4020 
4030 
4040 
4050 
4060 
4070 
4080 
4090 
4100 



{** Routines to issue commands to the terminal **} 

PROCEDURE BeginSegmentCSegmentNumber : IntType) ;{}{}{}{}{}{}{}{}{}{}{}{ } 

} BEGIN 

} {** (ESCMSMO) »*} 
} SendASCII(Esc); 

} SendASCII(LetterS); 

} SendASCII(LetterO); 

} Sendlnt(SegmentNumber) 

} END; 

h }{}{}{} nut hhhh h hhh hhh moo onnnu {}{}{}{}{} nun 

PROCEDURE DeleteSegment(SegmentNumber : IntType); {}{}{}{}{}{}{}{}{}{} 
} BEGIN 

} {** (ESC)(S)(K) **} 
} SendASCII(Esc) ; 

} SendASCII(LetterS); 

} SendASCII(LetterK); 

} Sendlnt(SegmentNumber) ; 
} END; 
}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}(}{}{}{}{}{}{} 

ROCEDURE DisableGin(DeviceAndFunction : IntType) ;{}{}{}{}{}{}{}{}{}{ } 

} BEGIN 

} {** (ESCXIHD) **} 

} SendASCII(Esc); 

} SendASCII(Letterl); 

} SendASCII(LetterD); 

} Sendlnt(DeviceAndFunction) 

} END; 

}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}U{}{} 

ROCEDURE Draw(Xy : XyType) ;{}{}{}{}{ HHH H H H H H H H H H H H H H J 

} BEGIN 

} {«* (ESO(LHG) **} 

} Send ASCII (Esc); 

} SendASCII(LetterL); 

} SendASCII(LetterG); 

} SendXy(Xy) 

} END; 

}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{H}{} 
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4120 
4130 
4140 
4150 
4160 
4170 
4180 
4190 
4200 
4210 

*iCCU 

4230 
4240 
4250 
4260 
4270 
4280 
4290 
4300 
4310 
4320 
4330 
4340 
4350 
4360 
4370 
4380 
4390 
4400 
4410 
4420 
4430 
4440 
4450 
4460 
4470 
4480 
4490 
4500 
4510 
4520 
4530 
4540 
4550 
4560 
4570 
4580 
4590 
4600 



PROCEDURE EnabIeDiaiogArea(EnabieMode : IntType); {}{}{}{}{}{}{}{}{}{}{} 

{} BEGIN {} 

{} {** (ESC)(K)(A) «*} {} 

{} SendASCII(Esc); {} 

{} SendASCII(LetterK); {} 

{} SendASCII(LetterA); {} 

{} Sendlnt(EnableMode) {} 

{} END; { } 
{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{} 

PROCEDURE EnableGinCDeviceAndFunction, 

{} NumberOfEvents : IntType) ;{}{}{}{}{}{}{}{}{}{}{}{}{ } 

{} BEGIN fi 

{} {** (ESCMIME) **} {} 

{} SendASCII(Esc); {} 

{} SendASCII(Letterl); {} 

{} SendASCII(LetterE); {} 

{} Sendlnt(DeviceAndFunction) : u 

{} Send Int( Number Of Events) ; ' {} 

{} END; {} 
{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{} 

PROCEDURE EndSegment ; {}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{} 

( \ DET.TM r ■. 

{} {** (ESC)(S)(C) **} {} 

{} SendASCII(Esc) ; {} 

{} SendASCII(LetterS); {} 

{} SendASCII(LetterC) ; {} 

{} END; " {} 

{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{} 

PROCEDURE MoveCXy : XyType) ;{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{ } 
{} BEGIN {} 

{} {** (ESO(LXF) **} {} 

{} SendASCII(Esc); {} 

{} SendASCII(LetterL); {} 

{} SendASCII(LetterF) ; {} 

{} SendXy(Xy); {} 

{} END; {} 

{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{} 

PROCEDURE SetDialogAreaVisibilityCVisibilityMode : IntType) ;{}{}{}{}{}{ } 

{} BEGIN { i 

{} {** (ESC)(L)(V) **} {} 

{} SendASCII(Esc); {} 

{} SendASCII(LetterL); {} 

{} SendASCII(LetterV); {} 

{} Sendlnt(VisibilityMode) {} 

{} END; { } 
{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{} 
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4610 P 


4620 { 


4630 { 


4640 { 


4650 { 


4660 { 


4670 { 


4680 { 


4690 { 


4700 


4710 P 


4720 { 


4730 { 


4740 { 


4750 f 


4760 { 


4770 { 


4780 { 


4790 { 


4800 { 


4810 { 


4820 { 


4830 


4840 P 


4850 { 


4860 { 


4870 { 


4880 { 


4890 { 


4900 { 


4910 { 


4920 { 


4930 { 


4 94 { 


4950 


4960 P 


4970 { 


4980 { 


4990 { 


5000 { 


5010 { 


5020 { 


5030 { 


5040 { 



PROCEDURE SetEolString(EolString : IntArrayType) ; {}{}{}{}{}{}{}{}{}{} 
"} BEGIN 

} {«* (ESCMNHT) **} 

} SendASCII(Esc) ; 

} SendASCII(LetterN); 

} SendASCII(LetterT); 

} SendlntArray(EolString) ; 

} END; 

}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{} 

ROCEDURE SetGinGridding(DeviceAndFunetion : IntType ; 

} XGridSpacing, YGridSpacing : IntType); {}{}{} 

} BEGIN 

} {** (ESC)(I)(G) **} 

) SendASCIKEsc): 

} SendASCIKLetterl); 

} SendASCII(LetterG); 

} Sendlnt(DeviceAndFunction) ; 

} Send Int(XGr id Spacing) ; 

} Sendlnt(YGridSpacing) ; 

} END; 

}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{} 

ROCEDURE SetGinRubberbanding(DeviceAndFunction : IntType; 

} Rubber-banding : IntType); {}{}{}{}{}{}{} 

} BEGIN 

} {** (ESCMIMR) **} 

} SendASCIKEsc); 

} SendASCII(Letterl); 

} SendASCII(LetterR); 

} Send Int(DeviceAndFunction) ; 

} Send int( Rubberbanding) ; 

} END; 

}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{} 

ROCEDURE SetReportEomFrequency(FrequencyCode : IntType); {}{}{}{}{}{} 

} BEGIN 

} {** (ESC)(I)(L) **} 

} SendASCIKEsc); 

} SendASCIKLetterl); 

} SendASCIKLetterM) ; 

} Sendlnt( FrequencyCode) ; 

} END; 

}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{ H HHHHH }(}{}(}{} 
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5050 PROCEDURE SetReportMaxLineLength(Length : IntType); {}{}{}{}{}{}{}{}{}{} 

5060 { } BEGIN " ; \ 

5070 {} {** (ESCMIMM) **} {} 

5080 {} SendASCII(Esc); \\ 

5090 {} SendASCII(Letterl); {} 

5100 {} SendASCII(LetterL); {} 

5110 {} Sendlnt(Length) ; {** a length of zero disables the feature **} {} 

5120 {} END; " U 

5130 {}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}(}{}{}(>{)() 
5140 

5150 PROCEDURE SetReportSigChars( ReportTypeCode , 

-" uu w sigcnar, 

5180 {} BEGIN TermSigChar : IntType); {}{}{}{}{}{}{}{}{}{} 

5190 {} {** (ESC)(I)(S) »*} J! 

5200 {} SendASCII(Esc); ){ 

5210 {} SendASCII(Letterl); }} 

5220 {} SendASCII(LetterS): :x 

5230 {} Sendlnt( ReportTypeCode) ; :\ 

5240 {} Sendlnt(SigChar); H 

5250 {} Sendlnt(TerraSigChar) ; H 

5260 {} END; f { 

5270 {}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{} 

5280 

5290 {** Routines used by the mainline **} 

5300 

5310 PROCEDURE Handshake ;{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{ } 

5320 {} VAR n 

5330 {} I : 1..5; 

5340 {} , 

5350 {} BEGIN J J 

5360 {} {** Issue <report-401 0-status> command **} {} 

5370 {} SendASCII(Esc); \\ 

5380 {} SendASCII(5); {** (ENQ) **} sx 

5390 {} {**_Parse the <401 0-status-report> , crudely **} {} 

5400 {} it Eoln(TTY) THEN Readln(TTY); {} 

5410 {} FOR I := 1 TO 5 DO Get(TTY); t\ 

5420 {} END; }{ 

5430 {}f}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{} { } { } {}{}{}{} 
5440 

5450 PROCEDURE Displaylnstructions; {}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{} { } { }{ } 

5460 {} BEGIN n 

5470 {} Writeln(TTY); }\ 

5480 {} Writeln(TTY, 'Type - •); \\ 

5490 {} Writeln(TTY,' M to move,'); {} 

5500 {} Writeln(TTY,' D to draw,'); {} 

5510 {} Writeln(TTY,' X to exit this program.'); U 

5520 {} END; " [ } 

5530 {}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{} { } { } { } {}{}{}{}{}{}{}{}{]{}{}{} 
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5550 


5560 


5570 


5580 


5590 


5600 


5610 


5620 


5630 


5640 


5650 


5660 


5670 


5680 


5690 


5700 


5710 


5720 


5730 


5740 


5750 


5760 


5770 


5780 


5790 


5800 


5810 


5820 


5830 



PROCEDURE ParseGinReportltemAndTakeAppropriateAction; {}{}{}{}{}{}{}{} 
BEGIN 
{** Look for signature character **} 

WHILE NOT (TTY~ IN ['W, 'w' ]){* while next char is not W *} { 
DO BEGIN {** skip past the non-W character **} 

IF Eoln(TTY) { *» If next character is a (CR) »*} 
THEN 

Readln(TTY) { ** advance to 1st char of next line **} 
ELSE 

Get(TTY) {** advance to next char *«} 
END; 
Read(TTY,SignatureChar) ; 
IF (SignatureChar = *W ) 

THEN {** Parse a <GIN-locator-report> . **} 



Read(TTY, KeyChar) ; 
Par se An Xy Re po r t ( Xy ) 
IF KeyChar IN ['M* , 



m' 



'd< 



x'] 



THEN {** take the appropriate action *»} 
CASE KeyChar OF 



{} 
{} 
{} 
{} 
ELSE 



•M' 
•D' 
•X' 

END 
{*« 



, 'm' : Move(Xy) ; 
, 'd' : Draw(Xy); 
, 'x' : DisableGin(O); 

{** of CASE statement «*} 

If he typed an invalid key char **} 



Display Inst ructions; 

ParseGinReportltemAndTakeAppropriateAction procedure *} 
UOhtHHHHHHHH HHHHH HHHHHHHHHHHHHHHHH} 



END; 



END; 
{* of 
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5840 BEGIN 

5850 {** Prepare dialog area **} 

5860 EnableDialogAread ); 

5870 SetDialogAreaVisibility( 1 ) ; 

5880 {** Prepare for GIN **} 

5890 {** <set-EOL-string : (13)> **} 

5900 InitializeNewIntArray(IntArray) ; 

5910 Append To In t Ar r ay ( In t Array , 13) ; 

5920 SetEolString(IntArray) ; 

5930 SetReportSigChars(0,87, 119); {* (W) , (w) *} 

5950 SetReportMaxLineLength(72) ; 

5960 SetGinGridding(0, 100, 100); {* enable gridding **} 

5970 SetGinRubberbanding(0, 1); {* enable rubberbanding *} 

5980 {** Tell operator what to do **} 

5990 Handshake; {* Be sure previous commands have been executed 

6000 Displaylnstructions ; 

6010 {** Open a segment **} 

6020 DeleteSegment(-1 ); {** Delete all old segments. **} 

6030 BeginSegmentC 1 ) ; 

6040 {** Enable for GIN **} 

6050 EnableGin(0, 32767); {** "32767" means "many points" «*} 

6060 {** Loop until a <term-sig-char> is received. **} 

6070 REPEAT 

6080 Parse Gin Re port Item And Take Appropriate Action 

6090 UNTIL SignatureChar = 'w 1 ; 

6100 {** Close the segment. **} 

6110 EndSegment; 

6120 

6130 

6140 END. 



Error messages issued, 
u warning messages issueu. 



Highseg: 3P 
Lowseg : 1P 
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FORTRAN BLOCK MODE COMMUNICATIONS DRIVERS 

C INTRODUCTION. 

C 

C This example I/O system for the TEKTRONIX 41 IX Computer Display 

C Terminals was implemented during the development of these terminals 

C and is presented as one way to do it. The FORTRAN is very close to 

C the 1966 ANSI FORTRAN standard, deviating in ways acceptable to 

C most modern compilers. This I/O system supports not only the new 

C 41 IX block mode but also the 466X Interactive Digital Plotter block 

C mode as well, allowing direct access to plotter features through 

C the use of the 41 IX <PORT-COPY> command. This system assumes the 

C presence of two I/O routines from PLOT 10 Terminal Control System, 

C ADEIN and ADEOUT. In fact, this system may be integrated with TCS 

C to n r o v i d g bccgss to t h g new tcrminsls vis block mode. 

C 

C USER INTERFACE. 

C 

C These routines from this I/O system are the ones the user must 

C call to drive the system. 

C 

C IOINIT initializes the I/O system and the terminal. 

C IOEND shuts down the I/O system. 

C KYBDIN gets input from the keyboard, out of block mode. 

C FILIN gets input from a terminal file during a <C0PY> transfer. 

C SNDEOF sends an end-of-file to the terminal to end a <CCPY>. 

C BL0KG0 starts block mode transmissions. 

C BLKEND ends block mode transmissions. 

C PLTRBM turns plotter block mode on and off. 

C EMPTIN empties the input buffer of any extraneous characters. 

C STIN is the primary input routine. 

C DUMP flushes the output buffer. 

C STOUT is the primary output routine. 

C INTRAY translates an integer array into terminal format. 

C ADERAY translates an ADE array into terminal format. 

C INTPAK translates an integer into terminal format. 

C RELPAK translates a real into terminal format. 

C XYTRN translates an XY pair into terminal format. 

C INTUNP translates a terminal int-report into an integer. 

C RELUNP trnaslates a terminal real-report into a real. 

C XYUNP translates a terminal XY-report into an XY pair. 

C KIN2AS translates an integer into a string of digits. 

C KAS2IN translates a string of digits into an integer. 
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C In general, IOINIT is called once at the beginning of a program. 

C I0END is likewise called once at the end. KYBDIN is useful during 

C block mode to allow the operator to use the normal system input 

C features to edit the input. FILIN and SNDEOF are of use during 

C <COPY> operations between the host computer and the terminal. BLOKGO 

C must be called to put the software into block mode, and BLKEND may 

C be called to exit block mode. PLTRBM may be used to enable or 

C disable plotter block mode. Plotter block mode is of use either 

C when the plotter is connected between the terminal and the host 

C computer or, if connected to a peripheral port, between a <PORT-COPY> 

C command and an end-of-file indicator. This system assumes the plotter 

C address is 'A', and it sends plotter on and plotter off commands on 

C entering and leaving plotter block mode. EMPTIN is used to make 

C sure no unwanted characters are in the system input buffer before 

C a call to STIN (or KYBDIN or FILIN). STIN is the input 'hole' 

C through which all input flows. DUMP is used to force STOUT to flush 

C the system output buffer, and should be called seldomly if ever by 

C the typical program. STOUT is the output *hole» through which all 

C output flows, taking care of plotter block mode if enabled. Terminal 

C block mode is handled by lower level routines called by SiIN and 

C STOUT and is not directly accessible to the user. The last five 

C routines on the above list are very useful in formatting arguments 

C in commands to the terminal, but only XYTRN is of any use with the 

C plotter. 

r 

C INSTALLING THIS SYSTEM. 

C 

C In implementing this system, you may wish to make the buffers and 

C line lengths smaller. To do this, change the size of the arrays in 

C /COMM/ common to match your needs, change the initial values of 

C KBUFSZ in IOINIT and BLKEND and the values of JBLINE and JLINLN in 

C IOINIT. The dimension of the arrays in BLKOUT and BLKIN may also 

C be made smaller. Other installation considerations are discussed 

C in the following sections. 

C 

C ADEIN and ADEOUT. 

C 

C These routines are part the PLOT 10 Terminal Control System, but if 

C you do not have them, here is a brief description of them. ADEOUT 

C outputs an array of ASCII-dec imal-equivalent ( ADE ) characters to 

C the terminal. It should be able to transmit all 128 of the ASCII 

C characters, although only (ESC) and from (SP) to (_) are required 

C for this I/O system, if block mode with six-bit packing is used. 

C ADEIN inputs a line of characters from the terminal, ending with 

C but not including a carriage return. Its first argument is the 

C number of characters in the line, not counting trailing spaces, and 

C its second argument is the array for the characters. 

C 
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C INTEGRATING WITH TCS. 

C 

C To use this I/O with the PLOT 10 Terminal Control System, replace 

C TOUTST with STOUT and have TINSTR simply call STIN. In addition, 

C have INITT call IOINIT and FINITT call IOEND. If you had to use 

C buffer type 1 or 2, use block mode now by calling BL0KG0 from 

C INITT. If you have 4662A01 or 4663A01 PLOT 10 Utility Routines, 

C integrate calls to PLTRBM into PLON and PLOFF, with calls to do a 

C <P0RT-C0PY> and to SNDEOF in PLINIT, PLON and PLOFF as needed. 

C ANMODE should call BLKEND to dump the buffer in block mode, but 

C should contain a copy of /COMM/ common and set the variable KBMODE 

C back to one so that the software will reenter block immediately. 

C XYCNVT would benefit from a replacement of much of its code with a 

C call to XYTRN, which was modelled after XYCNVT anyway. ANSTR should 

C have the variable MAXLEN removed, including both executable lines of 

C code containing it, 

C 

C TRIMMING THIS SYSTEM. 

C 

C Since this is just an example of an I/O system, any portion of it 

C may be trimmed out as desired. The plotter block mode part of STOUT 

C is fairly easy to be rid of if attention is paid to the statement 

C numbers. The terminal block mode packing and unpacking routines 

C may be reduced in size by removing one or the other of the two methods 

C provided in each, the 'easy way' and the 'hard way'. Which part to 

C remove depends on the packing factors being used. See the first 

C executable line of PACKER and UNPACK for clarification of this. It 

C is also possible to remove many or all of the calls to the parameter 

C setting routines in IOINIT if the terminals being accessed are 

C already appropriately set up. However, the variables in /COMM/ must 

C still be set properly so the software can do its job. 

C 
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C THE CODE OF THE EXAMPLE I/O SYSTEM: 
C 



C SUBROUTINE — IOIN IT — 

C 

SUBROUTINE IOINIT 
IOINIT INITIALIZES ALL BLOCK MODE PARAMETERS AND ALL STANDARD 
COMM PARAMETERS TO SET UP THE SOFTWARE AND TERMINAL 
THESE VALUES SHOULD WORK ON MOST SYSTEMS CAPABLE OF FULL ASCII 
INPUT AND OUTPUT - LARGER LINE, BLOCK AND BUFFER SIZES MAY BE 
DESIRABLE FOR SYSTEMS ABLE TO HANDLE THEM 

SOME STANDARD COMM VALUES MAY NEED ADJUSTMENT FOR YOUR SYSTEM 
rriMMAjj /rnMRflv/ .tt nnF (?Rfi 1 

COMMON /C0MM/*k0UTP^K0UTBF(512),KINEND > KINPT f KINBUF(512), 
& KRESLU,KIGDEL,KPRMOD,KPRLEN,KPSTRG(10),KEOFLN,KEOFST(10), 
& KEOMC1,KEOMC2,KCHARS(4) ,KBUFSZ , KBPLOT , KBPSW , 
& KBARM,KBMODE,KHLENH,KHEADH(10),KHLENT,KHEADT(10),KCONTH, 
& KCONTT,KENDH,KENDT,KNXNOH,KNXMTH(20),KNXNOT,KNXMTT(20), 
& KMASTH,KMASTT,KBYTEH,KBYTET,KPACKH,KPACKT,KBLENH,KBLENT, 
& KB LINE, KBLOKH, KtVfti , KEOMH, KEOFH, KEOMT, KEOFT 
DIMENSION JPSTRGC2) , JEOFSTO ) ,JEOLST(1 ) 
DIMENSION JtitflDi (5 ) ,jntiDnn; , jtiX^i i u 1 1 , u&Ai"i m\0 , 
BLOCK MODE PARAMETER DATA STATEMENTS 

TERMINAL-TO-HOST HOST-TO-TERMINAL 
DATA JHEADT /33 .VI, 35 , 36, 37/ , JHEADH /38, 125, 1 25, HI , 12/ 



C * 



DATA JNXMTT /126/, 

DATA JMASTT / 1 26/ , 

DATA JCONTT /97/, 

DATA JENDT /98/, 

DATA JBYTET /7/, 

DATA JPACKT /6/, 

DATA JBLENT /516/, 

DATA JBLINE /256/ 

STANDARD COMM DATA STATEMENTS 

DATA JPSTRG /63 , 32/ 

DATA JPRMOD /0/ 



/I 3,0/ 



JNXMTH /96,97,98,17,19,0/ 

JMASTH /96/ 

JCONTH /97/ 

JENDH /98/ 

JBYTEH /7/ 

JPACKH /7/ 

JBLENH /516/ 





Time ct 

ULUl *J 1 


1 w / 


DATA 


JEOMC1, 


, JEOMC2 


DATA 


JIGDEL 


/O/ 


DATA 


JRESLU 


/12/ 


DATA 


JXMTLM 


/2400/ 


DATA 


JXMTDL 


/100/ 


DATA 


JBREAK 


/200/ 


DATA 


JFLAG 


/3/ 


DATA 


JQUEUE 


/1000/ 


DATA 


JEOLST 


/13/ 


DATA 


JBYPAS 


/10/ 


DATA 


JLINLN 


/256/ 


DATA 


JREOMF 


/1/ 
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C * SET THE FIRST CHARACTER IN THE COMMAND ARRAY COMMON TO <ESC> 

JCODEC1 ) = 27 
C * SET I/O BUFFER POINTERS 
KOUTPT=0 

KINPTrO 

KIHEND=0 
C * INITIALIZE XY CHARACTERS 
DO 10 1=1,5 

KCHARS(I)=0 
10 CONTINUE 

C * SET OUTPUT BUFFER SIZE (SHOULD BE AS LARGE AS POSSIBLE) 
C * (ALSO SET IN BLKEND) 

KBUFSZ=256 
C * SET TERMINAL AND PLOTTER BLOCK MODES TO OFF 

KBARM=0 

KBMODE=0 

KBP T T = n 

KBPSW=0 
C * SET ALL STANDARD COMM PARAMETERS FIRST 

CALL PSTRNG (2.JPSTRG) 

CALL PROMPT (JPRMOD) 

CALL EOMCHR ( JE0MC1 , JECMC2) 

CALL EOFSTG (O.JEOFST) 

CALL IGNDEL (JIGDEL) 

CALL XMTDLY (JXMTDL) 

CALL XMTLMT (JXMTLM) 

CALL BREAKT (JBREAK) 

CALL FLAG (JFLAG) 

CALL QUEUES (JQUEUE) 

CALL EOLSTG (1 , JEOLST) 

CALL BYPCAN (JBYPAS) 

CALL LINLEN (JLINLN) 

CALL REOMF (JREOMF) 
C * SET INTERNAL RESOLUTION FLAG TO 12-BIT (10-BIT IS FASTER BUT UGLIER) 

CALL RESLUT (JRESLU) 
C * SET ALL BLOCK MODE PARAMETERS 

CALL BHEADR (5 , JHEADT, 5, JHEADH ) 

CALL BNONCR ( 1 , JNXMTT, 6, JNXMTH ) 

CALL BMASTC ( JMASTT, JMASTH ) 

CALL BCONTC ( JCCNTT , JCONTH ) 

CALL BENDCH ( JENDT, JENDH ) 

CALL BLKLEN ( JBLENT, JBLENH ) 

CALL BLINE (JBLINE) 

CALL BPACK ( JBYTET, JPACKT, JBYTEH, JPACKH ) 

CALL BTOUT (5) 
C » ARM BLOCK MODE FOR USE AFTER CALL TO BLOKGO 
C CALL BLKARM (1 ) 

RETURN 

END 
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C 

C SUBROUTINE — IOEND — 

C 

SUBROUTINE IOEND 
C * IOEND SHUTS DOWN THE SOFTWARE I/O SYSTEM 

COMMON /COMM/ KOUTPT , KOUTBF(5 12) .KINEND, KINPT , KINBUF(5 12) , 
& KRESLU,KIGDEL,KPRMOD,KPRLEN,KPSTRG(10) , KEOFLN , KEOFST( 1 0) , 
& KEOMC1,KEOMC2,KCHARS( 4 ),KBUFSZ, KBPLOT, KBPSW, 
& KBARM,KBMODE,KHLENH,KHEADH(10) , KHLENT, KHEADT ( 1 0) ,KCONTH, 
& KC0NTT,KENDH,KENDT,KNXN0H,KNXMTH(20) .KNXNOT, KNXMTT(20) , 
& KMASTH,KMASTT,KBYTEH,KBYTET,KPACKH,KPACKT,KBLENH,KBLENT, 
& KBLINE , KBLOKH , KEOPH , KEOMH, KEOFH, KEOMT, KEOFT 
C * TURN OFF BLOCK MODE 
CALL BLKEND (2) 
CALL BLKARM (0) 
C * TURN OFF PROMPT MODE IF IT WAS ON 

IF (KPRMOD.GT.O) CALL PROMPT (0) 
C * CLEAR THE OUTPUT BUFFER 
CALL DUMP 
RETURN 
END 
C 

C SUBROUTINE— KYBDIN — 

C 

SUBROUTINE KYBDIN ( IREQ, IREC , ISTRNG) 
C * KYBDIN GETS KEYBOARD INPUT, EXITTING AND REENTERING 
C * TERMINAL AND PLOTTER BLOCK MODES IF NECESSARY 
C * IREQ - NUMBER OF CHARACTERS REQUESTED 
C * IREC - NUMBER OF CHARACTERS RECEIVED <= IREQ 
C * ISTRNG - STRING FOR ADE CHARACTERS 
C * KBMODE - S/W BLOCK MODE FLAG 
C * JBMODE - TEMPORARY FOR REMEMBERING KBMODE 
C * KBPLOT - PLOTTER BLOCK MODE FLAG 
C * JBPLOT - TEMPORARY FOR REMEMBERING KBPLOT 

COMMON /COMM/ KOUTPT , KOUTBF(5 1 2) , KINEND, KINPT , KINBUF( 5 1 2) , 
& KRESLU,KDELOY,KPRMOD,KPRLEN,KPSTRG(10) , KEOFLN , KEOFST( 1 0) , 
& KEOMC1 KEOMC2 KCHARSC!) KBUFSZ KBPLOT KBPSW 
& KBARM , KBMODE , KHLENH , KHEADH ( 1 0) ', KHLENT J KHEADT (10), KCONTH, 
& KCONTT,KENDH,KENDT,KNXNOH,KNXMTH(20) , KNXNOT , KNXMTT(20) , 
& KMASTH,KMASTT,KBYTEH,KBYTET,KPACKH,KPACKT,KBLENH,KBLENT, 
& KBLINE , KBLOKH , KEOPH , KEOMH , KEOFH , KEOMT, KEOFT 
DIMENSION ISTRNGC1 ) 
JBMODE=KBMODE 
JBPLOT=KBPLOT 
KBPLOT=0 
CALL BLKEND (2) 
CALL STIN (IREQ, IREC, ISTRNG) 
IF (JBMODE. EQ. 1) CALL BLOKGO 
KBPLOT=JBPLOT 
RETURN 
END 
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C 

C SUBROUTINE— PLTRBM — 

C 

SUBROUTINE PLTRBM (IBMODE) 
C * PLTRBM SETS THE PLOTTER BLOCK MODE FLAG 

C * IBMODE - MODE TO BE ESTABLISHED: 0=CONTINUOUS , 1=PLOTTER BLOCK 
C * KBPLOT - NEW MODE TO BE USED AFTER NEXT DUMP 
C * KBPSW - MODE CURRENTLY IN USE BY SOFTWARE 

COMMON /COMM/ KOUTPT , KOUTBF( 5 1 2 ) , KINEND, KINPT , KINBUF(5 1 2) , 
& KRESLU,KDELOY,KPRMOD,KPRLEN,KPSTRG(1O),KEOFLN,KEOFST(10) , 
& KEOMC1,KEOMC2,KCHARS(4) ,KBUFSZ , KBPLOT , KBPSW , 
& KBARM,KBMODE,KHLENH,KHEADH(10),KHLENT,KHEADT(10),KCONTH, 
& KCONTT,KENDH,KENDT,KNXNOH,KNXMTH(20) .KNXNOT , KNXMTTC20) , 
& KMASTH , KM ASTT , KBYTEH , KBYTET , KPACKH , KPACKT , KBLENH , KBLENT , 
& KBLINE , KBLOKH , KEOPH , KEOMH , KEOFH , KEOMT , KEOFT 

COMMON /COMRAY/ JCODEC256) 
C * BRING VALUE WITHIN VALID RANGE 

JBPLOT=MIN0(1 ,MAXO(0, IBMODE)) 
C * EXIT IF NO CHANGE IN MODES 

IF (JBPLOT.EO. KBPSW) RETURN 
C * IF ENTERING PLOTTER BLOCK MODE, ENABLE PLOTTER 

IF (KBPLOT. NE. 1) GO TO 10 

JCODE(2)=65 

JCODE(3)=69 

CALL STOUT (3.JCODE) 

KBPLOT=JBPLOT 

CALL DUMP 

KBUFSZ=KBUFSZ-11 

RETURN 
C * IF EXITTING PLOTTER BLOCK MODE, DISABLE PLOTTER 
10 KBPLOT=JBPLOT 

CALL DUMP 

KBUFSZ=KBUFSZ+11 

JCODE(2)=65 

JCODE(3)=70 

CALL STOUT (3.JCODE) 

RETURN 

END 
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C 

C SUBROUTINE--FILIN — 

r 

SUBROUTINE FILIN (I REO, IREC , ISTRNG, IEOF) 
C * FILIN INPUTS LINES FROM A TERMINAL FILE, SCANNING FOR EOF 
C * IREQST - NUMBER OF CHARS REQUESTED 
C * IRECVD - NUMBER OF CHARS RECEIVED 
C * ISTRNG - CALLERS INPUT ARRAY 
c * IE0 F - 1 IF EOF DETECTED, IF NOT 

COMMON /COMM/ KOUTPT , KOUTBF(51 2) ,KINEND, KINPT , KINBUF(5 1 2) , 
& KRESLU,KDELOY,KPRMOD,KPRLEN,KPSTRG(10),KEOFLN,KEOFST(10), 

& KEOMC 1 , KEOMC2 , KCHARS (H ) , KBUFSZ , KBPLOT , KBPSW , 
& KBARM,KBMODE,KHLENH,KHEADH(10),KHLENT,KHEADT(10),KCONTH, 
& KCONTT KENDH,KENDT,KNXNOH,KNXMTH(20) , KNXNOT, KNXMTTC20) , 
& KMASTH \ KM ASTT "iCBYTEH , KBYTET , KPACKH , KPACKT , KBLENH , KBLENT , 
& KBLINE,KBLOKH,KEOPH,KEOMH,KEOFH,KEOMT,KEOFT 

DIMENSION ISTRNGC1 ) 
C * ZERO THE RETURN LENGTH 

IREC=0 
C * BRANCH IF BUFFER HAS CHARACTERS IN IT 

IF (KINEND.GT.O) GO TO 40 
C * BRANCH TO GET MORE INPUT VIA BLOCK MODE 

IF (KBMODE.EQ. 1 ) GO TO 30 
C * DUMP THE OUTPUT BUFFER TO BE SURE COMMANDS ARE SENT 

CALL DUMP 
C * SIMULATE PROMPT FOR NON-PROMPTING SYSTEMS 
C * REMOVE THIS LINE FOR PROMPTING SYSTEMS 

IF (KPRMOD.GT.O) CALL ADEOUT (KPRLEN, KPSTRG) 
C * GET LINE OF INPUT FROM TERMINAL 

CALL ADEIN (KIMEND, KINBUF) 

KINPT=0 
C * BACK SCAN FOR EOF STRING 

KEOFT=0 

IF (KEOFLN.LE.O .OR. KINEND.LT . KEOFLN ) GO TO 40 

JINEND=KINEND 

JEOFPT=KEOFLN 
10 IF (JEOFPT.EO.O) GO TO 20 

-ri- /i/Tiinnr/ tT»rvn\ wu yrrnv QT { T mx? VT \ \ nri TO llf\ 

JINEND=JINEND-1 

JE0FPT=JE0FPT-1 

GO TO 10 
20 KINEND=JINEND 

KEOFT=1 

GO TO 20 
C * GET INPUT VIA BLOCK MODE 
30 KEOMH=1 

CALL BLOKIO 

KEOMH=0 

KINPT=0 
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C * MOVE CHARACTERS FROM INPUT BUFFER TO USER ARRAY 
C * EXIT IF REQUEST SATISFIED 
40 IF (IREC.GE.IREO) GO TO 70 
C * CHECK FOR EMPTY BUFFER 

IF (KINPT.GE.KINEND) GO TO 50 

IREC=IREC+1 

KINPT=KINPT+1 

ISTRNG(IREC)=KINBUF(KINPT) 

GO TO 40 
C * PAD WITH BLANKS 
50 JFIRST=IREC+1 

DO 60 I=JFIRST,IREQ 

ISTRNG(I)=32 
60 CONTINUE 

C * EXIT IF BUFFER NOT EMPTY 
70 IF (KINPT.LT.KINEND) GO TO 80 
C * ZERO THE INPUT BUFFER 

KINEND=0 

KINPT=0 
C * SET END-OF-FILE ONLY IF NO MORE CHARS IN BUFFER 
80 IEOF=0 

IF (KE0FT.EQ.1 .AND. KINEND.EQ.O) IE0F=1 

RETURN 

END 
C 

C SUBROUTINE--SNDEOF 

C 

SUBROUTINE SMDEOF 
C * SNDEOF SENDS AN END-OF-FILE INDICATOR TO THE TERMINAL 

COMMON /COMM/ KOUTPT , K0UTBFC5 1 2) , KINEND, KINPT , KINBUF( 5 12 ) , 
& KRESLU,KDELOY,KPRMOD,KPRLEN,KPSTRG(10),KEOFLN,KEOFST(10) , 
& KE0MC1 , KE0MC2, KCHARS (4 ) , KBUFSZ , KBPLOT, KBPSW , 
& KBARM,KBMODE,KHLENH,KHEADH(10) .KHLENT, KHEADT( 1 ) .KCONTH, 
& KCONTT,KENDH,KENDT,KNXNOH,KNXMTH(20) , KNXNOT , KNXMTT(20) , 
& KMASTH, KMASTT , KBYTEH , KBYTET, KPACKH , KPACKT , KBLENH , KBLENT , 
& KBLINE,KBLOKH,KEOPH,KEOMH,KEOFH,KEOMT,KEOFT 
C * BRANCH FOR BLOCK MODE 

IF (KBMODE .EQ. 1 ) GO TO 20 
C * SEND EOF STRING TO TERMINAL 

IF (KEOFLN.GT.O) CALL STOUT (KEOFLN, KEOFST) 

RETURN 
C * FOR BLOCK MODE, SET EOF BIT AND DUMP BUFFER 
20 KE0FH=1 

CALL DUMP 

KEOFH=0 

RETURN 

END 
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C 

C — SUBROUTINE— BLOKGO — 

C 

SUBROUTINE BLOKGO 
C * BLOKGO STARTS BLOCK MODE IN OPERATION 

COMMON /COMM/ KOUTPT, KOUTBFC5 12) ,KINEND, KINPT , KINBUF(5 12) , 
& KRESLU,KIGDEL,KPRMOD,KPRLEN,KPSTRG(10) ,KEOFLN , KEOFST( 1 0) , 
& KEOMC1 ,KE0MC2,KCHARS(4) ,KBUFSZ , KBPLOT, KBPSW , 
& KBARM,KBM0DE,KHLENH,KHEADH(10) ,KHLENT, KHEADT ( 1 0) .KCONTH, 
& KCONTT,KENDH,KENDT,KNXNOH,KNXMTH(20) .KNXNOT, KNXMTT(20) , 
& KMASTH,KMASTT,KBYTEH,KBYTET,KPACKH,KPACKT,KBLENH,KBLENT, 
& KBLINE, KBLOKH , KEOPH , KEOMH.KEQFH, KEOMT, KEOFT 
C * IF BLOCK MODE NOT ARMED, EXIT 

IF (KBARM.NE.1) RETURN 
C * IF ALREADY IN BLOC k"m ODE, EXIT 

IF (KBM0DE.EQ.1) RETURN 
C * DUMP BUFFER TO GET CLEAN ENTRY INTO BLOCK MODE 

CALL DUMP 
C * SET CONTROL BYTE BITS 

KBLOKH =1 

KtUPH=0 

KEOFH=0 

KEOMH=0 
C » PUT SOFTWARE INTO BLOCK PROTOCOL 

KBM0DE=1 
C * CHANGE OUTPUT BUFFER SIZE TO BLOCK SIZE 

KBUFSZ=KBLENH-4 

IF (KBPSW.EQ.1) KBUFSZ=KBUFSZ-1 1 
C « TURN TERMINAL ECHO ON 

CALL ECHO (1 ) 

RETURN 

END 
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C 

C SUB ROUT INE--BLKEND 

C 

SUBROUTINE BLKF.ND (IACK) 
C * BLKEND ENDS THE BLOCK MODE PROTOCOL BUT DOES NOT DISARM BLOCK MODE 
COMMON /COMM/ KOUTPT , KOUTBFC 5 1 2 ) , KINEND, KINPT , KINBUF ( 5 1 2 ) , 
h. KRESLU,KIGDEL,KPRMOD,KPRLEN,KPSTRG(10) , KEOFLN , KEOFSTC 1 0) , 
& KE0MC1,KE0MC2,KCHARS(4) , KBUFSZ , KBPLOT , KBPSW , 
& KBARM,KBMODE,KHLENH,KHEADH(10) ,KHLENT , KHEADT ( 1 0) ,KC0NTH, 
& KCONTT,KENDH,KENDT,KNXNOH,KNXMTH(20) , KNXNOT , KNXMTT( 20) , 
& KM ASTH , KM ASTT , KBYTEH , KB YTET , KPACKH , KPACKT , KBLENH , KBLENT , 
& KBLINE,KBLOKH,KEOPH,KEOMH,KEOFH,KEOMT,KEOFT 
C * IF NOT IN BLOCK MODE, EXIT 

IF (KBMODE.EQ.O) RETURN 
C * TURN OFF TERMINAL ECHO (IF IT SHOULD NOT BE ON NORMALLY) 

CALL ECHO (0) 
r * jrT T H lr CC\' TC !OL Rtt? to rfjri fwr BLOCK PROTOCOL 
KBLOKH=0 

KEOPH=MINO(3,MAXO(2, IACK)) 
C * DUMP THE BUFFER AND TURN OFF SOFTWARE BLOCK MODE 
CALL DUMP 
KBMODE=0 
C * RESTORE OUTPUT BUFFER SIZE 
KBUFSZ=256 

IF (KBPSW. EQ.1) KBUFSZ=KBUFSZ-11 
RETURN 
END 
C 
C SUBROUTINE— BLKARM 

C 

SUBROUTINE BLKARM (IARM) 
C * BLKARM ARMS/DISARMS BLOCK MODE 
C * IARM - BLOCK MODE ARM/DISARM 
C » JCODE - COMMAND ARRAY 
C * LEN - LENGTH OF IONOFF AS PACKED INTEGER 

COMMON /COMM/ KOUTPT , K0UTBF(5 12) , KINEND, KINPT , KINBUF(5 12) , 
& KRESLU,KIGDEL,KPRMOD,K-PRLEN,KPSTRG(10) , KEOFLN, KE0FSTC10) , 
& KE0MC1 ,KE0MC2,KCHARS(4) , KBUFSZ , KBPLOT, KBPSW, 
& KBARM,KBMODE,KHLENH,KHEADH(10),KHLENT,KHEADT(10),KCONTH, 
& KCONTT,KENDH,KENDT,KNXN0H,KNXMTH(20) , KNXNOT, KNXMTT(20) , 
& KM ASTH , KM ASTT , KBYTEH , KB YTET , KPACKH , KPACKT , KBLENH , KBLENT , 
& KBLINE , KBLOKH , KEOPH , KEOMH, KEOFH, KEOMT, KEOFT 
COMMON /COMRAY/ JCODE(256) 
DIMENSION JINRAY(5) ,JENQ(2) 
DATA JENQ/27,5/ 
JC0DE(2)=79 
JCODE(3)=66 

CALL INTPAK (I ARM , LEN, JCODE (4 ) ) 
CALL STOUT (LEN+3 , JCODE) 
KBARM=MIN0(1 , MAXO(0 , IARM) ) 
C * REQUEST STATUS TO ALLOW TERMINAL TIME TO CHANGE MODES 
CALL STOUT (2.JENQ) 
CALL EMPTIN 

CALL STIN (5, JREC.JINRAY) 
RETURN 
END 
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C 

C SUBROUTINE— BLKLEN — 

C 

SUBROUTINE BLKLEN (IBLENT, IBLENH ) 
C * BLCOKL SETS THE BLOCK LENGTHS 
C « IBLENT - TERMINAL'S BLOCK LENGTH 
C * IBLENH - HOST'S BLOCK LENGTH 
C * JCODE - COMMAND ARRAY 

C « LEN1 - LENGTH OF IBLENT AS PACKED INTEGER 
C « LEN2 - LENGTH OF IBLENH AS PACKED INTEGER 

COMMON /COMM/ KOUTPT , KOUTBF(5 12) .KINEND, KINPT, KINBUF(5 12) , 
& KRESLU,KIGDEL,KPRMOD,KPRLEN,KPSTRG(10) ,KEOFLN , KEOFST( 1 0) , 
& KE0MC1,KE0MC2,KCHARS(4),KBUFSZ,KBPL0T,KBPSW, 
a R.DHrm, KdMODE , rvni^cwn , MitHun ^ iu/^ni,iNi,NntHUH iu;,^unin, 
& KCONTT,KENDH,KENDT,KNXNOH,KNXMTH(20),KNXNOT,KNXMTT(20), 
& KM ASTH , KM ASTT , KBYTEH , KBYTET , KPACKH , KPACKT , KBLENH , KBLENT , 
& KBLINE , KBLOKH , KEOPH , KEOMH, KEOFH, KEOMT, KEOFT 
COMMON /COMRAY/ JCODE (256) 
JC0DE(2)=79 
JCODE(3)=83 
KBLENHrlBLENH 
KBLENT=IBLENT 

CALL INTPAK (IBLENT, LEN1 , JCODE (4 ) ) 
CALL INTPAK (IBLENH, LEN2, JCODE (LEN1+4) ) 
CALL STOUT (LEN 1 +LEN2+3 , JCODE ) 
RETURN 
END 
C 

C SUBROUTINE— BENDCH— 

C 

SUBROUTINE BENDCH (IENDT, IENDH ) 
C » BENDCH SETS THE BLOCK END CHARACTERS 
C * IENDT - TERMINAL'S BLOCK END CHARACTER 
C * IENDH - HOST'S BLOCK END CHARACTER 
C » JCODE - COMMAND ARRAY 

C « LEN1 - LENGTH OF IENDT AS PACKED INTEGER 
C * LEN2 - LENGTH OF IENDH AS PACKED INTEGER 

burinuh / \s\jnn/ ivuui ri , nuuidt ^ b i £■ ) ^incnu, Mnn , mNdut \o i c ) , 
& KRESLU,KIGDEL,KPRM0D,KPRLEN,KPSTRG(10) .KEOFLN, KE0FST( 1 0) , 
& KEOMC1,KEOMC2,KCHARS(4),KBUFSZ,KBPLOT,KBPSW, 
& KBARM , KBMODE , KHLENH , KHEADH (10), KHLENT , KHEADT (10), KCONTH , 
& KCONTT,KENDH,KENDT,KNXNOH,KNXMTH(20),KNXNOT,KNXMTT(20), 
& KM ASTH , KMASTT , KBYTEH , KBYTET , KPACKH , KPACKT , KBLENH , KBLENT , 
& KBLINE, KBLOKH, KEOPH, KEOMH, KEOFH, KEOMT, KEOFT 
COMMON /COMRAY/ JCODE(256) 
JCODE(2)=79 
JCODE(3)=69 
KENDH=IENDH 
KENDT=IENDT 

CALL INTPAK (IENDT, LEN1 , JCODE (*4 ) ) 
CALL INTPAK (IENDH, LEN2, JCODE (LEN1+H ) ) 
CALL STOUT (LEN1+LEN2+3, JCODE) 
RETURN 
END 
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C 

C SUBROUTINE--BCONTC 

C 

SUBROUTINE BCONTC ( ICONTT, ICONTH) 

C * BCONTC SETS THE BLOCK CONTINUE CHARACTERS 

C * ICONTT - TERMINAL'S BLOCK CONTINUE CHARACTER 

C * ICONTH - HOST'S BLOCK CONTINUE CHARACTER 

C * JCODE - COMMAND ARRAY 

C * LEN1 - LENGTH OF ICONTT AS PACKED INTEGER 

C » LEN2 - LENGTH OF ICONTH AS PACKED INTEGER 

COMMON /COMM/ KOUTPT , KOUTBF(5 1 2) , KINEND, KINPT , KINBUFC5 12) , 
& KRESLU,KIGDEL,KPRMOD,KPRLEN,KPSTRG(10) .KEOFLN , KEOFST ( 1 0) , 
& KEOMC1 ,KEOMC2,KCHARS(4) , KBUFSZ , KBPLOT, KBPSW, 
& KBARM,KBMODE,KHLENH,KHEADH(10) ,KHLENT, KHEADTC 1 0) .KCONTH, 
& KCONTT,KENDH,KENDT,KNXNOH,KNXMTH(20),KNXNOT,KNXMTT(20), 
- & KMASTH,KMASTT,KBYTEH,KBYTET,KPACKH,KPACKT,KBLENH,KBLENT, 
» voi tvt mi r\vu vvrwu vtamu yurwv ifrpwT ifroCT 

COMMON /COMRAY/ JCODE(256) 

JCODE(2)=79 

JCODE(3)=67 

KCONTH=ICONTH 

KCONTT=ICONTT 

CALL INTPAK (ICONTT, LEN1 , JC0DE(4 ) ) 

CALL INTPAK (ICONTH, LEN2, JCODE(LEN1+4) ) 

CALL STOUT (LEN1+LEN2+3, JCODE) 

RETURN 

END 
C 
C SUBROUTINE— BMASTC — 

C 

SUBROUTINE BMASTC ( IMASTT, IMASTH ) 
C » BMASTC SETS THE BLOCK MASTER CHARACTERS 
C » IMASTT - TERMINAL'S MASTER CHARACTER 
C » IMASTH - HOST'S MASTER CHARACTER 
C « JCODE - COMMAND ARRAY 

C * LEN1 - LENGTH OF IMASTT AS PACKED INTEGER 
C * LEN2 - LENGTH OF IMASTH AS PACKED INTEGER 

COMMON /COMM/ KOUTPT , KOUTBF(5 12) .KINEND, KINPT , KINBUF(512) , 
& KRESLU, KIGDEL, KPRMOD, KPRLEN, KPSTRG( 1 0) , KEOFLN , KE0FST( 1 0) , 
& KE0MC1,KE0MC2,KCHARS(4) , KBUFSZ, KBPLOT, KBPSW, 
& KBARM,KBMODE,KHLENH,KHEADH(10) .KHLENT, KHEADT( 1 0) , KCONTH, 
& KCONTT,KENDH,KENDT,KNXNOH,KNXMTH(20),KNXNOT,KNXMTT(20), 
4 KM ASTH , KM ASTT , KBYTEH , KBYTET , KPACKH , KPACKT , KBLENH , KBLENT , 
& KBLINE , KBLOKH , KEOPH , KEOMH , KEOFH , KEOMT , KEOFT 
COMMON /COMRAY/ JCODE(256) 
JC0DE(2)=79 
JCODE(3)=77 
KMASTH=IMASTH 
KMASTT=IMASTT 

CALL INTPAK (IMASTT, LEN1 , JCODE (4 ) ) 
CALL INTPAK (IMASTH, LEN2, JCODE (LEN1 +4 ) ) 
CALL STOUT (LEN1+LEN2+3 , JCODE) 
RETURN 
END 
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C 

C SUBROUTINE— BPACK--- 

C 

SUBROUTINE BPACK (IBST, IPKT , IBSH, IPKH ) 

C * BPACK SETS THE BIT PACKING VALUES 

C * IBST - TERMINAL'S UNPACKED BITS/CHAR 

C » IPKT - TERMINAL'S PACKED BITS/CHAR 

C * IBSH - HOST'S UNPACKED BITS/CHAR 

C * IPKH - HOST'S PACKED BITS/ CHAR 

C * JCODE - COMMAND ARRAY 

C * LEN1 - LENGTH OF PARAMETER AS PACKED INTEGER 

C * LEN2 - TOTAL LENGTH OF COMMAND 

COMMON /COMM/ KOUTPT , KOUTBF(5 1 2) .KINEND, KINPT , KINBUF(51 2) , 
& KRESLU,KIGDEL,KPRMOD,KPRLEN,KPSTRG(10) , KEOFLN , KEOFST( 1 0) , 
& KEOMC1 JKE0MC2,'KCHARS(iT) ,KBUFSZ , KBPLOT, KBPSW , 
& KB ARM , KBMODE , KHLENH , KHEADH ( 1 ) , KHLENT , KHEADT (10), KCONTH , 
& KCONTT,KENDH,KENDT,KNXNOH,KNXMTH(20),KNXN0T,KNXMTT(20), 
& KMASTH , KM ASTT , KBYTEH , KBYTET , KPACKH , KPACKT , KBLENH , KBLENT , 
& KBLINE , KBLOKH , KEOPH , KEOMH , KEOFH, KEOMT, KEOFT 
COMMON /COMRAY/ JCODE(256) 

J^UL-'t Kd j- t 1 

JCODE(3)=80 

KBYTEH=2**IBSH 

KBYTET=2**IBST 

KPACKH=2*«IPKH 

KPACKT=2**IPKT 

LEN2=4 

CALL INTPAK (IBST, LEN1 , JCODE (LEN2) ) 

LEN2=LEN2+LEN1 

CALL INTPAK (IPKT , LEN1 , JCODE (LEN2) ) 

LEN2=LEN2+LEN1 

CALL INTPAK (IBSH, LEN1 , JCODE (LEN2) ) 

LEN2=LEN2+LEN1 

CALL INTPAK (IPKH, LEN1 , JC0DE(LEN2) ) 

LEN2=LEN2+LEN1-1 

CALL STOUT (LEN2, JCODE) 

RETURN 

run 

c 

C SUBROUTINE— BTOUT — 

C 

SUBROUTINE BTOUT (ITIME) 
C * BTOUT SETS THE TERMINAL'S BLOCK TIMEOUT 
C * ITIME - SECONDS BEFORE RETRANSMITTING BLOCK 
C * JCODE - COMMAND ARRAY 
C * LEN - LENGTH OF ITIME AS PACKED INTEGER 

COMMON /COMRAY/ JCODE(256) 

JC0DE(2)=79 

JCODE(3)=84 

CALL INTPAK (ITIME, LEN, JCODE (M ) ) 

CALL STOUT (LEN+3 , JCODE) 

RETURN 

END 
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C 

C SUB ROUT INE--BNONCR 

C 

SUBROUTINE BNONCR (INXNOT , INXMTT, INXNOH , INXMTH ) 
C * BNONCR SETS THE BLOCK NON-TRANSMITTABLE CHARACTERS 
C * INXNOT - NUMBER OF TERMINAL NON-XMT CHARS 
C * INXMTT - ARRAY OF TERMINAL'S NON-XMT CHARS 
C * INXNOH - NUMBER OF HOST'S NON-XMT CHARS 
C * INXMTH - ARRAY OF HOST'S NON-XMT CHARS 
C * JCODE - COMMAND ARRAY 

C * LEN1 - LENGTH OF TERMINAL ARRAY AS PACKED INTEGERS 
C * LEN2 - LENGTH OF HOST ARRAY AS PACKED INTEGERS 

COMMON /COMM/ KOUTPT , KOUTBF(5 1 2 ) , KINEND, KINPT , KINBUFC 5 1 2 ) , 
& KRESLU,KIGDEL,KPRMOD,KPRLEN,KPSTRG(10) .KECFLN , KEOFST( 1 0) , 
& KE0MC1,KE0MC2,KCHARS(4) ,KBUFSZ , KBPLOT , KBPSW , 
& KBARM,KBMODE,KHLENH,KHEADH(10) ,KHLENT , KHEADT( 1 0) , KCONTH, 
& KCONTT,KENDH,KENDT,KNXNOH,KNXMTH(20) .KNXNOT , KNXMTT(20 ) , 
& KMASTH, KMASTT, KBYTEH, KBYTET, KPACKH , KPACKT, KBLENH , KBLENT , 
& KBLINE,KBLOKH,KEOPH,KEOMH,KEOFH,KEOMT,KEOFT 

COMMON /COMRAY/ JCODEC256) 

DIMENSION INXMTTM ) ,INXMTH(1 ) 

JCODE(2)=79 

JCODE(3)=78 

KNXNOH=M INO (20, MAXO(0, INXNOH)) 

IF (KNXNOH.EQ.O) GO TO 20 

DO 10 1=1 .KNXNOH 
10 KNXMTH(I) = INXMTH(I) 

20 KNXN0T=MIN0 ( 20, MAXO(0, INXNOT)) 

IF (KNXNOT. EO.O) GO TO 40 

DO 30 1=1 , KNXNOT 
30 KNXMTT(I)=INXMTT(I) 
no CALL INTRAY (INXNOT, INXMTT, LEN1 , JCODE (4 ) ) 

CALL INTRAY (INXNOH , INXMTH , LEN2, JCODE (LEN1 +4 ) ) 

CALL STOUT (LEN1+LEN2+3 , JCODE ) 

RETURN 

END 
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C 

C SUBROUTINE--BHEADR--- 

C 

SUBROUTINE BHEADR (IHLENT , IHEADT, IHLENH , IHEADH ) 
C * BHEADR SETS THE BLOCK HEADERS 
C * IHLENT - LENGTH OF TERMINAL'S HEADER 
C * IHEADT - TERMINAL'S HEADER 
C * IHLENH - LENGTH OF HOST'S HEADER 
C * IHEADH - HOST'S HEADER 
C * JCODE - COMMAND ARRAY 

C * LEN1 - LENGTH OF TERMINAL HEADER AS PACKED INTEGERS 
C * LEN2 - LENGTH OF HOST HEADER AS PACKED INTEGERS 

nnMMDN /r.nMM/ ICOUTPT .KOUTBFC512) .KINEND. KINPT.KINBUF(512) , 
& KRESLU,KIGDEL,KPRMOD,KPRLEN,KPSTRG(10),KEOFLN,KEOFST(10), 
& KE0MC1,KE0MC2,KCHARS(4) , KBUFSZ , KBPLOT, KBPSW , 
& KBARM,KBMODE,KHLENH,KHEADH(10),KHLENT,KHEADT(10),KCONTH, 
& KC0NTT,KENDH,KENDT,KNXN0H,KNXMTH(20),KNXN0T,KNXMTT(20), 
& KMASTH,KMASTT,KBYTEH,KBYTET,KPACKH,KPACKT,KBLENH,KBLENT, 
& KBLINE,KBLOKH,KE0PH,KE0MH,KE0FH,KEOMT,KEOFT 
COMMON /COMRAY/ JCODE (256) 
DIMENSION IHEADTO ) .IHEADHO ) 

JCODE(3)=72 

KHLENH=MIN0(20,MAX0(0, IHLENH)) 

IF (KHLENH.EQ.O) GO TO 20 

DO 10 1=1 .KHLENH 
10 KHEADH(I)=IHEADH(I) 
20 KHLENT=MINO(20,MAXO(0, IHLENT)) 

IF (KHLENT.EQ.O) GO TO 40 

DO 30 1=1 ,KHLENT 
30 KHEADT(I)=IHEADT(I) 
40 CALL INTRAY (IHLENT, IHEADT, LEN1 , JCODE (4 ) ) 

CALL INTRAY (IHLENH , IHEADH , LEN2, JCODE (LEN1+4 ) ) 

CALL STOUT (LEN1+LEN2+3 , JCODE ) 

RETURN 

END 
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C 

C SUBROUTINE--BLINE 

C 

SUBROUTINE BLINE (ILENTH) 
C * BLINE SETS THE BLOCK LINE LENGTH 
C * ILENTH - BLOCK LINE LENGTH 
C * JCODE - COMMAND ARRAY 
C * LEN - LENGTH OF ILENTH AS PACKED INTEGER 

COMMON /COMM/ KOUTPT , KOUTBFC 5 1 2 ) , KINEND, KINPT , KINBUFC 5 1 2 ) 
& KRESLU, KIGDEL, KPRMOD, KPRLEN, KPSTRG( 1 0) ,KECFLN , KEOFST ( 1 0) ' 
& KE0MC1,KE0MC2,KCHARS(i»),KBUFSZ,KBPL0T,KBPSW, * ' 
& KBARM, KBMODE, KHLEMH , KHEADHC 1 0) ,KHLENT, KHEADT( 1 0) , KCONTH 
& KCONTT,KENDH,KENDT,KNXNOH,KNXMTH(20),KNXNOT,KNXMTT(20) ' 
& KMASTH,KMASTT,KBYTEH,KBYTET,KPACKH,KPACKT,KBLENH,KBLENT 
& KBLIME,KBLOKH,KEOPH,KEOMH,KEOFH,KEOMT,KEOFT ' " 
COMMON /COMRAY/ JCODEC256) 
JCODE (2) =79 
JCODE(3)=76 

CALL INTPAK ( ILENTH , LEN, JCODE (4 ) ) 
CALL STOUT (LEN+3 , JCODE ) 

KBLINE=M INO (256, MAXO( 50, ILENTH)) 

RETURN 

END 
C 

C SUBROUTINE— ECHO — 

C 

SUBROUTINE ECHO (IECHO) 
C * ECHO TURNS THE TERMINAL ECHO ON OR OFF 
C * IECHO - FOR OFF, 1 FOR ON 

COMMON /COMRAY/ JCODE(256) 

JCODE(2)=75 

JCODE(3)=69 

CALL INTPAK ( IECHO, LEN, JCODE (if ) ) 

CALL STOUT (LEN+3 , JCODE ) 

RETURN 

END 
C 

C SUBROUTINE— FLAG--- 

C 

SUBROUTINE FLAG (IFLAG) 
C * FLAG SETS THE FLAGGING MODE AT THE TERMINAL 
C * IMODE - FLAGGING MODE [0,5] 
C » JCODE - COMMAND ARRAY 
C * LEN - IMODE AS PACKED INTEGER 

COMMON /COMRAY/ JCODE(256) 

JCODE(2)=78 

JCODE(3)=70 

CALL INTPAK (IFLAG, LEN, JCODE (U ) ) 

CALL STOUT (LEN+3 , JCODE ) 

RETURN 

END 
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C 

C SUBROUTINE— XMTLMT 

C 

SUBROUTINE XMTLMT (LIMIT) 
C * XMTLMT SETS THE TERMINAL-TO-HOST TRANSMIT LIMIT 
C * LIMIT - BAUD RATE LIMIT [110,19200] 
C * JCODE - COMMAND ARRAY 
C * LEN - LENGTH OF LIMIT AS PACKED INTEGER 

COMMON /COMRAY/ JCODE(256) 

JC0DE(2)=78 

JC0DE(3)=76 

CALL INTPAK (LIMIT , LEN, JCODE (U ) ) 

CALL STOUT (LEN+3 , JCODE ) 

RETURN 

END 
C 

C SUBROUTINE— BREAKT 

C 

SUBROUTINE BREAKT (IDELAY) 
C * BREAKT SETS THE TERMINALS BREAK TIME DELAY 
C * IDELAY - BREAK DELAY IN MILLISECONDS 
C * JCODE - COMMAND ARRAY 
C * LEN - LEN OF IDELAY AS PACKED INTEGER 

COMMON /COMRAY/ JCODE (256) 

JCODE(2)=78 

JCODE(3)=75 

CALL INTPAK (IDELAY, LEN, JCODE (4 ) ) 

CALL STOUT (LEN+3 , JCODE ) 

RETURN 

END 

C 

C SUBROUTINE— PROMPT — 

C 

SUBROUTINE PROMPT (IONOFF) 
C * PROMPT TURNS TERMINAL PROMPT MODE ON AND OFF 
C * IONOFF - PROMT MODE ON/OFF [0,2] 
C * JCODE - COMMAND ARRAY 
C * LEN - LENGTH OF IONOFF AS PACKED INTEGER 

COMMON /COMM/ KOUTPT , K0UTBF(5 1 2) , KINEND, KINPT , KINBUF( 5 1 2) , 
& KRESLU,KDEL0Y,KPRM0D,KPRLEN,KPSTRG(10) ,KE0FLN , KE0FST( 1 0) , 
& KE0MC1,KE0MC2,KCHARSCO .KBUFSZ , KBPLOT , KBPSW, 
& KBARM,KBMODE,KHLENH,KHEADH(10) ,KHLENT , KHEADT( 1 0) , KCONTH, 
& KC0NTT,KENDH,KENDT,KNXN0H,KNXMTH(20) , KNXNOT, KNXMTT(20) , 
& KMASTH,KMASTT,KBYTEH,KBYTET,KPACKH,KPACKT,KBLENH,KBLENT, 
& KBLINE , KBLOKH , KEOPH', KEOMH, KEOFH, KEOMT, KEOFT 
COMMON /COMRAY/ JCODE (256) 
JCODE(2)=78 
JCODE(3)=77 

CALL INTPAK(IONOFF,LEN, JCODE (4)) 
CALL ST0UT(LEN+3, JCODE) 
KPRMOD=IONOFF 
RETURN 
END 
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C 

C SUBROUTINE— EOMCHR — 

C 

SUBROUTINE EOMCHR ( ICHAR1 , ICHAR2 ) 
C * EOMCHR SETS THE TERMINAL EOM CHARACTERS 
C * ICHAR1 - FIRST EOM CHARACTER 
C * ICHAR2 - SECOND EOM CHARACTER 
C * JCODE - COMMAND ARRAY 

C * LEN1 - LENGTH OF ICHAR1 AS PACKED INTEGER 
C * LEN2 - LENGTH OF ICHAR2 AS PACKED INTEGER 

COMMON /CCMM/ KOUTPT , KOUTBFC 5 1 2 ) , KINEND , KINPT , KINBUFC 5 1 2 ) 
& KRESLU,KDELOY,KPRMOD,KPRLEN,KPSTRG(10),KEOFLN,KEOFST(10) 
& KEOMC1 , KEOMC2, KCHARS(4 ) ,KBUFSZ , KBPLOT , KBPSW, 
& KB ARM , KBMODE , KHLENH , KHEADH (10), KHLENT , KHEADT (10), KCONTH, 
& KCONTT,KENDH,KENDT,KNXNOH,KNXMTH(20),KNXNOT,KNXMTT(20) , 
& KMASTH,KMASTT.KBYTEH.KBYTET.KPACKH,KPflf:J(T.KRT.B-NH. (CRT twt 
& KBLINE,KBLOKH,KEOPH,kEOMH,KEOFH,KEOMT,KEOFT 

COMMON /COMRAY/ JCODE(256) 

JCODE(2)=78 

JCODE(3)=67 

CALL INTPAK (ICHAR1 , LEN1 , JCODE (4 ) ) 

CALL INTPAK ( ICHAR2, LEN2, JCODE (LEN1+4 ) ) 

CALL STOUT (LEN 1+LEN2+3 , JCODE ) 

KEOMC1=ICHAR1 

KEOMC2=ICHAR2 

RETURN 

END 
C 

C SUB ROUT INE--XMTDLY 

C 

SUBROUTINE XMTDLY (IMSEC) 
C * XMTDLY SETS THE TERMINAL TRANSMIT DELAY IN MILLISECONDS 
C * IMSEC - MILLISECONDS OF DELAY 
C * JCODE - COMMAND ARRAY 
C * LEN - LENGTH OF IMSEC AS PACKED INTEGER 

COMMON /COMRAY/ JCODE(256) 

JCODE(2)=78 

JCODE(3)=68 

CALL INTPAK (IMSEC , LEN, JCODE (4 ) ) 

CALL STOUT (LEN+3 , JCODE ) 

RETURN 

END 
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C 

C SUBROUTINE — PSTRNG 

C 

SUBROUTINE PSTRNG (NUM.IARRAY) 
C * PSTRNG SETS THE TERMINAL'S PROMPT STRING 
C * NUM - NUMBER OF CHARACTERS IN THE PROMPT STRING 

C * IARRAY - ARRAY CONTAINING ADE OF PROMPT STRING 
C * JCODE - COMMAND ARRAY 
C * LEN - LENGTH OF PROMPT STRING AS PACKED INTEGERS 

COMMON /COMM/ KOUTPT , KOUTBF(51 2) , KINEND, KINPT , KINBUF(5 1 2 ) , 
& KRESLU,KDELOY,KPRMOD,KPRLEN,KPSTRGC10) .KEOFLN , KEOFSTC 1 0) , 
& KE0MC1,KE0MC2,KCHARS(4),KBUFSZ,KBPL0T,KBPSW, 
& KBARM.KBMODE.KHLENH.KHEADHCIO) . KHLENT . KHEADT ( 1 ) .KCONTH, 
& KCONTf,KENDH;KENDT,kNXNOH,KNXMTH(20) , KNXNOT, KNXMTT(20) , 
& KMASTH,KMASTT,KBYTEH,KBYTET,KPACKH,KPACKT,KBLENH,KBLENT, 
& KBLINE , KBLOKH , KEOPH , KEOMH , KEOFH , KEOMT , KEOFT 
COMMON /COMRAY/ JCODE (256) 
DIMENSION IARRAYO ) 
JCODE(2)=78 
JCODE (3 ) = 83 
CALL INTRAY (NUM , IARRAY, LEN, JCODE (M ) ) 

v^HL,^ biUui vLh,B+j,in<uut; 

KPRLEN=MIN0(10,MAX0(NUM,0)) 

IF (KPRLEN.EQ.O) RETURN 

DO 100 Ir1 .KPRLEN 

KPSTRG(I)=IARRAY(I) 
100 CONTINUE 

RETURN 

END 
C 
C SUB ROUT INE— EOLSTG— 

C 

SUBROUTINE EOLSTG (NUM.ICHAR) 
C * EOLSTG SETS THE TERMINAL END-OF-LINE STRING 

C * NUM - NUMBER OF CHARACTERS IN THE EOL SEQUENCE (TERM-STRING) 
C * ICHAR - ARRAY HOLDING ADE OF EOL SEQUENCE (...) 
C * JCODE - COMMAND ARRAY 
C * LEN - LENGTH OF EOL SEQUENCE AS PACKED INTEGERS 

COMMON /COMRAY/ JC0DE(256) 

JCODE (2)=78 

JCODE(3)=8U 

CALL INTRAY (NUM , ICHAR, LEN, JCODE(« ) ) 

CALL STOUT (LEN+3 , JCODE) 

RETURN 

END 
C 

C SUBROUTINE--BYPCAN 

C 

SUBROUTINE BYPCAN (ICHAR) 
C * BYPCAN SETS THE TERMINAL'S BYPASS CANCEL CHARACTER 
C * ICHAR - BYPASS CANCEL CHARACTER 
C * JCODE - COMMAND ARRAY 
C * LEN - LENGTH OF ICHAR AS PACKED INTEGER 

COMMON /COMRAY/ JCODE(256) 

JCODE(2)=78 

JCODE(3)=85 

CALL INTPAK (ICHAR, LEN, JCODE (4 ) ) 

CALL STOUT (LEN+3, JCODE ) 

RETURN 

END 
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C 

C SUBROUTINE— QUEUES — 

C 

SUBROUTINE QUEUES (IBYTE) 
C * QUEUES SETS THE TERMINAL'S INPUT QUEUESIZE 
C * IBYTE - SIZE OF QUEUE IN BYTES 
C * JCODE - COMMAND ARRAY 

C * LEN - LENGTH OF IBYTE AS PACKED INTEGER 
COMMON /COMRAY/ JCODEC256) 
JCODE(2)=78 
JCODE(3)=S1 

CALL INTPAK (IBYTE , LEN, JCODE (4 ) ) 
CALL STOUT (LEN+3 , JCODE ) 
RETURN 
END 
C 

C SUBROUTINE— EOFSTG — 

C 

SUBROUTINE EOFSTG (NUM.IARRAY) 

COMMON /COMM/ KOUTPT , KOUTBF(5 1 2) ,KINEND, KINPT , KINBUFC5 12) , 
& KRESLU,KDELOY,KPRMOD,KPRLEN,KPSTRG(10) , KEOFLN , KEOFST( 1 0} , 
& KEOMC1,KEOMC2,KCHARS(U),KBUFSZ,KBPLOT,KBPSW, 
& KBARM,KBMODE,KHLENH,KHEADH(10),KHLENT,KHEADT(10),KCONTH, 
& KCONTT,KENDH,KENDT,KNXNOH,KNXMTH(20) .KNXNOT, KNXMTT(20) , 
& KMASTH , KM ASTT , KBYTEH , KBYTET , KPACKH , KPACKT , KBLENH , KBLENT , 
& KBLINE , KBLOKH , KEOPH , KEOMH, KEOFH, KEOMT, KEOFT 
COMMON /COMRAY/ JCODE(256) 
DIMENSION IARRAYC1 ) 
JCODE(2)=78 
JCODE(3)=69 

CALL INTRAY (NUM , IARRAY, LEN, JCODE (1 ) ) 
CALL STOUT (LEN+3 , JCODE ) 
KEOFLN =MINO(10,MAXO(NUM,0)) 
IF (KEOFLN. EQ.O) RETURN 
DO 100 1=1 .KEOFLN 
KEOFST(I)=IARRAY(I) 
100 CONTINUE 
RETURN 
END 
C 

C SUBROUTINE — IGNDEL — 

C 

SUBROUTINE IGNDEL (IGNORE) 

COMMON /COMM/ KOUTPT , K0UTBF(5 1 2 ), KINEND, KINPT , KINBUF(5 1 2) , 
& KRESLU,KDELOY,KPRMOD,KPRLEN,KPSTRG(10) .KEOFLN , KEOFST( 1 0) , 
& KE0MC1.KE0MC2.KCHARSCO , KBUFSZ , KBPLOT, KBPSW , 
& KBARM,KBMODE,KHLENH,KHEADH(10) .KHLEHT, 'CHEAPT ( 1 ) .KCOMTH, 
& KCONTT,KENDH,KENDT,KNXNOH,KNriTH(20) , KNXNOT, KNXMTT(20) , 
& KMASTH, KM ASTT, KBYTEH, KBYTET, KPACKH, KPACKT, KBLENH, KBLENT, 
& KBLINE, KBLOKH , KEOPH , KEOMH, KEOFH, KEOMT, KEOFT 
COMMON /COMRAY/ JCODE (256) 
JCODE(2)=75 
JCODE(3)=73 

CALL INTPAK (IGNORE, LEN, JCODE (4 ) ) 
CALL STOUT (LEN+3 , JCODE ) 
KDEL0Y=MIN0(1 , MAXO(0 , IGNORE ) ) 
RETURN 
END 
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C 

C SUBROUTINE— LINLEN 

C 

SUBROUTINE LINLEN (ILEM) 
C * LINLEN SENDS THE SET-MAX-LINE-LENGTH COMMAND 

COMMON /COMRAY/ JCODE(256) 

JCODE(2)=73 

JCODE(3)=76 

CALL INTPAK (ILEN, JLEN, JCODE (4 ) ) 

CALL STOUT (JLEN+3 , JCODE ) 

RETURN 

END 
C 

C SUB ROUT INE--REOMF 

C 

SUBROUTINE REOMF (IREOMF) 
C * REOMF SENDS SET-REPORT-EOM-FREQUENCY COMMAND 

COMMON /COMRAY/ JCODE(256) 

JCODE(2)=73 

JCODE (3 )=7? 

CALL~INTPAK (IREOMF, JLEN, JCODE (4)) 

CALL STOUT (JLEN+3 , JCODE ) 

RETURN 

END 

C 

C SUBROUTINE— RESLUT — 

C 

SUBROUTINE RESLUT (IRESLU) 

COMMON /COMM/ KOUTPT , KOUTBF(5 1 2) , KINEND, KINPT , KINBUF(5 1 2) , 
& KRESLU,KDELOY,KPRMOD,KPRLEN,KPSTRG(10) .KEOFLN , KEOFST( 1 0) , 
& KEOMC1,KEOMC2,KCHARS(4) ,KBUFSZ .KBPLOT, KBPSW, 
& KBARM , KBMODE , KHLENH , KHEADH (10), KHLENT , KHEADT (10), KCONTH , 
& KCONTT,KENDH,KENDT,KNXNOH,KNXMTH(20),KNXNOT,KNXMTT(20), 
& KM ASTH , KM ASTT , KBYTEH , KBYTET , KPACKH , KPACKT , KBLENH , KBLENT , 
& KBLINE , KBLOKH , KEOPH , KEOMH, KEOFH , KEOMT, KEOFT 
KRESLU=12 

IF (IRESLU. LT. 12) KRESLU=10 
RETURN 
END 
C 

C SUBROUTINE— EMPT IN-- ■ 

C 

SUBROUTINE EMPTIN 
C » EMPTIN ZEROES THE INPUT BUFFER 

COMMON /COMM/ KOUTPT, K0UTBF(5 1 2) , KINEND, KINPT , KINBUF(5 1 2 ) , 
& KRESLU,KIGDEL,KPRMOD,KPRLEN,KPSTRG( 10), KEOFLN, KE0FST( 10), 
& KEOMC1,KEOMC2,KCHARS(U),KBUFSZ, KBPLOT, KBPSW, 
& KBARM , KBMODE , KHLENH , KHEADH (10), KHLENT , KHEADT ( 1 ) , KCONTH , 
& KCONTT,KENDH,KENDT,KNXN0H,KNXMTH(20),KNXNOT,KNXMTT(20), 
& KM ASTH, KMASTT, KBYTEH, KBYTET, KPACKH, KPACKT, KBLENH, KBLENT, 
& KBLINE, KBLOKH, KEOPH, KEOMH, KEOFH, KEOMT, KEOFT 
KINEND=0 
KINPTrO 
RETURN 
END 
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C 

C SUBROUTINE--STIN 

C 

SUBROUTINE STIN (I REQ, IREC , ISTRNG) 
C * STIN RETURNS CHARACTERS FROM ITS INPUT BUFFER, GETTING MORE 
C * INPUT FROM THE TERMINAL IF THE BUFFER IS EMPTY 

C * IT PADS THE USER ARRAY WITH SPACES IF LESS THAN REQUESTED IS RECEIVED 
C * IREQ - NUMBER OF CHARACTERS REQUESTED 
C * IREC - NUMBER OF CHARACTERS ACTUALLY RETURNED 
C * ISTRNG - ARRAY FOR RETURNED ADE STRING 
C » KINEND - POINTER TO END OF INPUT IN KINBUF 
C * KINPT - POINTER TO CURRENT POSITION IN KINBUF 
C * KINBUF - INPUT BUFFER 

C * KPRMOD - PROMPT MODE FLAG: - OFF, 1 - ON 
C * KPRLEN - LENGTH OF PROMPT STRING 
C * KPSTRG - ARRAY FOR PROMPT STRING 

COMMON /COMM/ KO'JTFT , KOUTBF( 5 1 2 ) , KINEND, KINPT , KINBUF (5 1 2 ) , 
& KRESLU.KIGDEL, KPRMOD, KPRLEN, KPSTRG ( 10) , KEOFLN , KEOFST( 1 0) , 
& KE0MC1,KE0MC2,KCHARS(1) , KBUFSZ , KBPLOT, KBPSW , 
& KBARM,KBMODE,KHLENH,KHEADH(10),KHLENT,KHEADT(10),KCONTH, 
& KCONTT,KENDH,KENDT,KNXN0H,KNXMTH(20) , KNXNOT, KNXMTTC20) , 
& KMASTH,KMASTT,KBYTEH,KBYTET,KPACKH,KPACKT,KBLENH,KBLENT, 
& KBLINE , KBLOKH , KEOPH , KEOMH, KEOFH, KEOMT, KEOFT 

DIMENSION ISTRNGd) 
C * ZERO THE RETURN LENGTH 

IREC=0 
C * BRANCH IF BUFFER HAS CHARACTERS IN IT 

IF (KINEND. GT.O) GO TO 20 
C * BRANCH TO GET MORE INPUT VIA BLOCK MODE 

IF (KBMODE.EQ. 1 ) GO TO 10 
C * DUMP THE OUTPUT BUFFER TO BE SURE COMMANDS ARE SENT 

CALL DUMP 
C * SIMULATE PROMPT FOR NON-PROMPTING SYSTEMS 
C * REMOVE THIS LINE FOR PROMPTING SYSTEMS 

IF (KPRMOD. GT.O) CALL ADEOUT (KPRLEN, KPSTRG ) 
C * GET LINE OF INPUT FROM TERMINAL 

CALL ADEIN (KINEND, KINBUF ) 

KINPTrO 

GO TO 20 
C * GET INPUT VIA BLOCK MODE 
10 KEOMH=1 

CALL BLOKIO 

KEOMHrO 

KINPT=0 
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C * MOVE CHARACTERS FROM INPUT BUFFER TO USER ARRAY 
C » EXIT IF REQUEST SATISFIED 
20 IF (IREC.GE.IREQ) GO TO 50 
C * CHECK FOR EMPTY BUFFER 

IF (KINPT.GE.KINEND) GO TO 30 

IREC=IREC+1 

KINPT=KINPT+1 ' 

ISTRNG(IREC)=KINBUF(KINPT) 

GO TO 20 
C * PAD WITH BLANKS 
30 JFIRST=IREC+1 

DO 40 I=JFIRST,IREQ 

ISTRNG(I)=32 
jjq CONTINUE 

C * EXIT IF BUFFER NOT EMPTY 
50 IF (KINPT.LT.KINEND) RETURN 
C * ZERO THE INPUT BUFFER 

KINEND=0 

KINPT=0 

RETURN 

END 
C 

C SUBROUTINE — DUMP 

C 

SUBROUTINE DUMP 
C * DUMP DUMPS THE OUTPUT BUFFER 

DIMENSION IDUMMYd ) 

CALL STOUT (O.IDUMMY) 

RETURN 

END 
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C 

C SUBROUTINE--STOUT 

C 

SUBROUTINE STOUT (ILEN, ISTRNG) 
C * STOUT IS THE GENERAL OUTPUT ROUTINE WHICH SHOULD BE USED FOR ALL 
C * OUTPUT TO THE 41 IX TERMINALS 

C * IT BUFFERS OUTPUT, BREAKING THE INPUT STRING INTO BUFFER-SIZE 
C * CHUNKS IF THE STRING IS TOO LONG 
C * ILEN - NUMBER OF CHARACTERS TO BE TRANSMITTED 
C * ISTRNG - ARRAY HOLDING ADE STRING TO BE TRANSMITTED 
C » JBSIZE - SIZE OF BUFFER (LINESIZE OR BLOCK LENGTH) 
C * JNUM - NUMBER OF CHARACTERS TO BE BUFFERED 'THIS TIME* 
C * JSENT - NUMBER OF CHARACTERS ALREADY MOVED INTO BUFFER 
C * KOUTBF - OUTPUT BUFFER 
C * KOUTPT - POINTER TO END OF OUTPUT BUFFER 

COMMON /COMM/ KOUTPT , KOUTBF(5 1 2 ) ,KINEND, KINPT , KINBUF(5 1 2 ) , 
* KRESLU.KTGDEL.KPRMOD.KPRLEN.KPSTRGdO) , KEOFLN , KEOFST( 1 0) , 
& KEOMC1JKEOMC2', KCHARS(4 ), KBUFSZ , KBPLOT , KBPSW, 
& KBARM,KBMODE,KHLENH,KHEADH(10) .KHLENT , KHEADT ( 1 0) , KCONTH , 
& KCONTT,KENDH,KENDT,KNXNOH,KNXMTH(20) , KNXNOT, KNXMTT(20) , 
& KMASTH,KMASTT,KBYTEH,KBYTET,KPACKH,KPACKT,KBLENH,KBLENT, 
& KBLINE , KBLOKH , KEOPH , KEOMH , KEOFH, KEOMT, KEOFT 

DIMENSION ISTRNGO ) 
C * SET NUMBER ALREADY SENT TO ZERO 

JSENT=0 
C * DUMP BUFFER IF ILEN IS NOT POSITIVE 

IF (ILEN.LE.O) GO TO 40 
C * GET NUMBER TO BUFFER 'THIS TIME 1 
10 JNUM=MIN0 (ILEN- JSENT, KBUFSZ -KOUTPT) 

C » IF BUFFER EMPTY AMD IN PLOTTER BLOCK MODE, PUT BLOCK START IN 

IF (KOUTPT. GT.O .OR. KBPSW.NE.1) GO TO 20 

KOUTPT=3 

KOUTBFd ) = 27 

KOUTBF(2)=65 

KOUTBF(3)=40 
C * INSERT CHARACTERS INTO BUFFER 
20 DO 30 1=1 , JNUM 

KOUTPT=KOUTPT+1 

JSENT=JSENT+1 

KOUTBF( KOUTPT )= ISTRNG (JSENT) 
30 CONTINUE 
C * IF BUFFER NOT FULL, EXIT 

IF (KOUTPT. LT. KBUFSZ) RETURN 
C * DUMP THE BUFFER 

C * SEE IF IN PLOTTER BLOCK MODE WITH SOMETHING IN BUFFER 
40 IF (KBPSW.NE.1 .OR. KOUTPT. EQ.O) GO TO 80 
C * COMPUTE CHECKSUM, PUT END-OF-BLOCK SEQUENCE INTO BUFFER 

JCHKSM=173 

DO 50 1=4, KOUTPT 

IF (KOUTBF(I) .EQ. 22) GO TO 50 

JCHKSM = JCHKSM+KOUTBF(I ) 
50 CONTINUE 
60 IF (JCHKSM.LT.4096) GO TO 70 

JCHKSM=JCHKSM-4095 
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GO TO 60 
70 KOUTPT=KOUTPT+1 

KOUTBF(KOUTPT)=27 

K0UTPT=K0UTPT+1 

KOUTBF(KOUTPT)=65 

KOUTPT=KOUTPT+1 

KOUTBF(KOUTPT)=41 

K0UTPT=K0UTPT+1 

CALL KIN2AS ( JCHKSM , U , 0, JLEN, KOUTBFCKOUTPT ) ) 

KOUTPT=KOUTPT+JLEN 

K0UTBF(K0UTPT)=13 

KE0MH=1 
C » BRANCH FOR BLOCK MODE 
80 IF (KBM0DE,EQ= 1 ) GO TO 90 

IF (KOUTPT.GT.OJ CALL ADEOUT (KOUTPT .KOUTBF) 

IF (KBPSW.EQ.1) CALL ADEIN (KINEND,KINBUF) 

GO TO 100 
90 CALL BLOKIO 

C * IF IN PLOTTER BLOCK MODE, SEE IF POSITIVE ACKNOWLEDGE 
100 IF (KBPSW.NE.1) GO TO 120 

IF (KINEND.LT.1 .OR. KINEND.GT. 2) GO TO 80 

IF (KINBL)F(KINEND).EQ.65) GO TO 110 

JTRY=JTRY+1 

IF (JTRY.LE.3) GO TO 80 
110 KEOMH=0 

KINEND=0 

KINPT=0 
C « BUFFER EMPTY NOW 
120 KOUTPT=0 

KBPSW=KBPLOT 
C * DO REST OF STRING IF THERE IS SOME LEFT 

IF (JSENT.LT.ILEN) GO TO 10 

RETURN 

END 
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C 

C SUBROUTINE— BLOKIO— 

C 

SUBROUTINE BLOKIO 
C » BLOKIO CALLS BLKOUT AND BLKIN TO PERFORM ONE BLOCK 'EXCHANGE' 
C * JNACK - NEGATIVE ACKNOWLEDGE INDICATOR 
C * JREPET - REPETITION COUNTER 
C » KEOPH - END-OF-PROTOCOL INDICATOR 
C » KBLOKH - BLOCK COUNTER (0 OR 1) 

COMMON /COMM/ KOUTPT, K0UTBF(512) .KINEND, KINPT , KINBUF(5 12) , 
& KRESLU,KIGDEL,KPRM0D,KPRLEN,KPSTRG(10),KEOFLN,KEOFST(10), 
& KEOMC1,KEOMC2,KCHARS(4),KBUFSZ,KBPLOT,KBPSW, 
& KBARM,KBMODE,KHLENH,KHEADH(10),KHLENT,KHEADT(10) .KCONTH, 
& KC0NTT,KENDH,KENDT,KNXN0H,KNXMTH(20) ,KNXNOT, KNXMTTC20) , 
& KM ASTH , KM ASTT , KBYTEH , KBYTET , KPACKH , KPACKT , KBLENH , KBLENT , 
& KBLINE , KBLOKH , KEOPH , KEOMH, KEOFH, KEOMT, KEOFT 
C » INITIALIZE REPETITION COUNTER AND ACKNOWLEDGE FLAG 

JREPET=0 

JNACK=0 
C * OUTPUT BLOCK TO TERMINAL 
10 CALL BLKOUT (JREPET) 

J R EPE T~JREPET+1 
C * GET BLOCK FROM TERMINAL UNLESS NO-ACK END OF PROTOCOL 

IF (KEOPH. NE. 3) CALL BLKIN (JNACK) 
C * IF FOURTH REPETITION, ASSUME OKAY 

IF (JREPET. EQ.4) GO TO 30 
C * IF NEGATIVE ACKNOWLEDGE, RETRANSMIT 

IF (JNACK. EO. 1) GO TO 10 
C * FLIP BLOCK COUNT, ZERO OUTPUT BUFFER 
20 KBL0KH=1 -KBLOKH 

KOUTPT=0 

RETURN 
C « GET OUT OF BLOCK MODE 
30 KBMODE=0 

CALL ADEOUT (KOUTPT , KOUTBF) 

KOUTPT=0 

KINENDsO 

RETURN 

END 
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C 

C SUBROUTINE— BLKOUT — - 

C 

SUBROUTINE BLKOUT (IREPET) 

COMMON /COMM/ KOUTPT , KOUTBF(5 12) .KINEND, KINPT , KINBUFC5 1 2) , 
& KRESLU,KIGDEL,KPRMOD,KPRLEN,KPSTRG(10),KEOFLN,KEOFST(10), 
& KEOMC 1 , KEOMC2, KCHARS (4 ) , KBUFSZ , KBPLOT , KBPSW , 
& KB ARM , KBMODE , KHLENH , KHEADH (10), KHLENT , KHEADT (10), KCONTH , 
& KCONTT,KENDH,KENDT,KNXNOH,KNXMTH(20) .KNXNOT , KNXMTT(20) , 
& KMASTH,KMASTT,KBYTEH,KBYTET,KPACKH,KPACKT,KBLENH,KBLENT, 
& KBLINE, KBLOKH , KEOPH , KEOMH, KEOFH, KEOMT, KEOFT 

DIMENSION JLINE(256),JBUF(684),JCTL(4) 

DATA JCTL(2)/0/ 

IF ( IREPET. GT . ) GO TO 15 
C* COMPUTE JCTLO) BLOCK COUNT, END PROTOCOL, END 
C* OF FILE, END OF MESSAGE 

JCTL( 1 )=KBLOKH+KEOPH+KEOFH*32+KEOMH*64 
C * COMPUTE CHECKSUM ON KOUTBF AND THE 
C * FIRST TWO CONTROL BYTES. 

CALL CHKSUM (KOUTPT , KOUTBF, JCTL, KBYTEH , JCHK1 , JCHK2) 

JCTL(3)=JCHK1 

JCTL(4)=JCHK2 

CALL PACKER ( JCTL, JBUFLN , JBUF) 
C* PUT BLOCK HEADER IN OUTPUT LINE 

DO 10 1=1 , KHLENH 

JLINE(I)=KHEADH(I) 
10 CONTINUE 

C * BUILD AND SEND LINES TO THE TERMINAL 
15 JBUFPT=0 
20 JLINPT=KHLENH 

C * GET NEXT CHARACTER FROM PACKED BUFFER 
30 JBUFPT=JBUFPT+1 

C * SEE IF PACKED BUFFER IS EMPTY 

IF (JBUFPT.GT. JBUFLN) GO TO 80 

JCHAR=JBUF(JBUFPT) 
C * SUBSTITUTE NON-TRANSMITTABLE CHARACTERS IF NEEDED 

JCNTR=0 
40 JCNTR=JCNTR+1 

IF (JCNTR.GT.KNXNOH) GO TO 50 

IF (JCHAR.NE.KNXMTH(JCNTR)) GO TO 40 

JLINPT=JLINPT+1 

JLINE(JLINPT) = KMASTH 

JLINPT=JLINPT+1 

JLINE(JLINPT)=64+JCNTR 

GO TO 60 
50 JLINPT=JLINPT+1 

JLINE(JLINPT)=JCHAR 
C « TEST FOR END OF PACKED CHARACTERS 
60 IF (JBUFPT.GE. JBUFLN) GO TO 80 
C * TEST FOR END OF LINE 

IF (JLINPT.GE.KBLINE-2) GO TO 70 



41 1 4 HOST PROGRAMMER'S @ C-43 



EXAMPLES OF CODE 



C* GO GET ANOTHER CHAR 

GO TO 30 
C * PUT IN CONTINUE CHAR AND SEND LINE TO TERMINAL 
70 JLINPT=JLINPT+1 

JLINE(JLINPT)=KCONTH 

CALL ADEOUT ( JLINPT , JLINE ) 

GO TO 20 
C * PUT IN END CHAR AND SEND LINE TO TERMINAL 
80 JLINPT=JLINPT+1 

JLINE(JLINPT)=KENDH 

CALL ADEOUT (JLINPT , JLINE ) 

RETURN 

END 
C 

C SUBROUTINE— PACKER — 

C 

SUBROUTINE PACKER (ICTL, ITNUM , ITBUF) 

COMMON /COMM/ KOUTPT , KOUTBFC5 1 2 j ,KINEND, KINPT , KINBUFC5 12) , 
& KRESLU,KIGDEL,KPRMOD,KPRLEN,KPSTRG(10),KEOFLN,KEOFST(10), 
& KEOMC1, KE0MC2, KCHARS(U) , KBUFSZ , KB PLOT, KBPSW , 
& KB ARM , KBMODE , KHLENH , KHEADH (10), KHLENT , KHEADT (10), KCONTH , 
& KC0NTT,KENDH,KENDT,KNXN0H,KNXMTH(20) .KNXNOT, KNXMTT(20 ) , 
& KMASTH , KMASTT , KBYTEH , KBYTET , KPACKH , KPACKT , KBLENH , KBLENT , 
& KBLINE , KBLOKH , KEOPH , KEOMH, KEOFH, KEOMT, KEOFT 

DIMENSION ICTL(1 ) ,ITBUF(1 ) 
C * FIRST, SEE IF NO PACKING IS NEEDED, IF SO BRANCH TO EASY PART 

IF (KBYTEH. EQ. KPACKH) GO TO 60 
C * INITIALIZE VARIABLES 

ITNUM=0 

JRP0W=1 

JREGSR=0 

JFCNT=0 

JCCNT=0 

JOFSET=0 

IF (KPACKH. EQ. 64) JOFSET=32 
C * GET A BYTE TO PUT INTO REGISTER 
10 JFCNT=JFCNT+1 

IF (JFCNT.GT. KOUTPT) GO TO 20 
C * GET BYTE FROM 'FROM' BUFFER 

JFBYTE=KOUTBF(JFCNT) 

GO TO 30 
C * GET BYTE FROM CONTROL BYTE ARRAY 
20 JCCNT=JCCNT+1 

IF (JCCNT.GT.4) GO TO 50 

JFBYTE=ICTL(JCCNT) 
C * SHIFT REGISTER BY 'FROM POWER', ADD 'FROM BYTE' 
30 JREGSR=JREGSR*KBYTEH+JFBYTE 

JRPOW=JRPOW*KBYTEH 
C * SEE IF ENOUGH IN REGISTER, IF NOT GET ANOTHER 'FROM* BYTE 
40 IF (JRPOW.LT. KPACKH) GO TO 10 
C * COMPUTE 'TO' SHIFT FACTOR 

JSHFT=JRPOW/KPACKH 
C * GET 'TO' BYTE 

JTBYTE=JREGSR/JSHFT 
C * RESET REGISTER 

JREGSR=JREGSR-JTBYTE»JSHFT 

JRPOW=JSHFT 
C * PUT 'TO' BYTE INTO BUFFER 

ITNUM=ITNUM+1 

ITBUF ( ITNUM) = J TBYTE+JOFSET 

GO TO 40 
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c * 


ALL DONE WITH DATA, NOW PAD LAST BYTE IF NECCESSARY 


50 


IF (JRPOW.EQ. 1) RETURN 




JREGSR=JREGSR*KPACKH/JRPOW 




JRPOW=KPACKH 




GO TO 40 


c * 


'EASY PART' - JUST MOVE BYTES STRAIGHT ACROSS 


60 


IF (KOUTPT.LE.O) GO TO 80 




DO 70 1=1 .KOUTPT 




ITBUF(I)=KOUTBF(I) 


70 


CONTINUE 


80 


DO 90 1=1,4 




J=KOUTPT+I 




ITBUF(J)=ICTL(I) 


90 


CONTINUE 




ITNUM=KOUTPT + '» 




RETURN 


C 


END 


c— 

c 


SUBROUTINE— BLKIN — 



C * BLKIN GETS A BLOCK FROM THE TERMINAL 

COMMON /COMM/ KOUTPT, K0UTBFC51 2) ,KINEND , KINPT , KINBUFC512) , 
& KRESLU,KIGDEL,KPRM0D,KPRLEN,KPSTRG(10) ,KEOFLN , KEOFST( 1 0) , 
& KE0MC1 ,KE0MC2,KCHARS(4),KBUFSZ,KBFLIM,KBPL0T, 
& KBARM , KBMODE , KHLENH , KHEADH (10), KHLENT , KHEADT (10), KCONTH , 
& KCONTT,KENDH,KENDT,KNXNOH,KNXMTH(20) .KNXNOT, KNXMTT(20) , 
& KMASTH , KMASTT , KBYTEH , KBYTET , KPACKH , KPACKT , KBLENH , KBLENT , 
& KBLINE , KBLOKH , KEOPH , KEOMH , KEOFH , KEOMT , KEOFT 

DIMENSION JBUF(684),JLINE(256),JCTL(4) 

DATA JCTL(2)/0/ 
C * INITIALIZE NUMBER OF PACKED CHARACTERS RECEIVED 

JNUM=0 
C * INITIALIZE MASTER CHARACTER FOUND FLAG 

JMASTR=0 
C * GET A LINE OF INPUT FROM THE TERMINAL 
C * SIMULATE PROMPT MODE IF TURNED ON 
10 IF (KPRMOD,GT,0) CALL ADEOUT (KPRLEN , KPSTRG) 

CALL ADEIN(JLEN.JLINE) 
C * IF WRONG LAST CHARACTER, NACK BLOCK 

IF (JLINE(JLEN).NE.KENDT .AND. JLINE ( JLEN ) . NE.KCONTT ) GO TO 90 
C * SCAN LINE FOR START OF HEADER 

JLINPT=0 
20 JLINPT=JLINPT+1 

IF (JLINPT.GE. JLEN) GO TO 90 

IF (JLINE(JLINPT).NE.KHEADT(I )) GO TO 20 
C * SCAN FOR REST OF HEADER 

JHEDPT=1 
30 JHEDPT=JHEDPT+1 

IF (JHEDPT.GT. KHLENT) GO TO 35 

JLINPT=JLINPT+1 

IF (JLINE(JLINPT).NE.KHEADT(JHEDPT)) GO TO 90 

GO TO 30 
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C * FILL TEMP BUFFER, TOTAL IN JNUM, DO NOT INCLUDE LAST CHAR 
C * IF MASTER CHAR DETECTED, THEN DO SUBSTITUTION 
35 IF (JMASTR.EQ. 1) GO TO 50 
40 JLINPT=JLINPT+1 

IF (JLINPT.GE. JLEN) GO TO 60 

IF (JLINE(JLINPT).EQ.KMASTT) GO TO 50 

JNUM=JNUM+1 

JBUF ( JNUM )= JLINE (JLINPT) 

GO TO 40 
50 JMASTR=1 

JLINPT=JLINPT+1 

IF (JLINPT.GE. JLEN) GO TO 10 

JSUB=JLINE (JLINPT )-64 

JNUM=JNUM+1 

JBUF(JNUM)=KNXMTT(JSUB) 

JMASTR=0 

GO TO 40 
C * GET ANOTHER LINE IF THIS WAS NOT THE LAST 
60 IF (JLINE(JLEN).EQ.KCONTT) GO TO 10 
C * UNPACK THE BUFFER, INTO STIN BUFFER IF EOM BIT SET 

IF (KEOMH.NE. 1) GO TO 70 

CALL UNPACK ( JNUM , JBUF ,KINEND , KINBUF , JCTL) 

IF (MOD(JCTL(1 ),4).NE.KBL0KH+KE0PH) GO TO 90 

CALL CHKSUM (KINEND , KINBUF , JCTL, KBYTET , JCHK1 , JCHK2) 
C * STRIP FINAL EOM CHAR 

IF (KINBUF(KINEND).EQ.KEOMCI .OR. KINBUF(KINEND) . EQ. KE0MC2 ) 
& KINEND=KINEND-1 

GO TO 80 
C » IF EOM IS NOT SET, THEN PUT RETURNING EMPTY BLOCK IN JLINE 
70 CALL UNPACK (JNUM , JBUF , JLEN , JLINE , JCTL) 

IF (M0D(JCTL(1 ) ,4).NE.KBL0KH+KE0PH) GO TO 90 

CALL CHKSUM ( JLEN , JLINE , JCTL, KBYTET , JCHK1 , JCHK2) 
80 IF (JCHK1.NE. JCTL(3) .OR. JCHK2. NE. JCTL(4 ) ) GO TO 90 
C * POSITIVE ACKNOWLEDGE 

INACK=0 

KE0MT=JCTL(1 )/64 

KE0FT=JCTL(1 )/32-KE0MT*2 

RETURN 
C * NEGATIVE ACKNOWLEDGE 
90 INACK=1 

RETURN 

END 
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C 

C SUBROUTINE— UNPACK — 

G 

SUBROUTINE UNPACK (IFNUM , IFBUF , ITNUM , ITBUF , ICTL) 

COMMON /COm/ KOUTPT,KOUTBF(512),KINEND,KINPT,KINBUF(512), 
& KRESLU,KIGDEL,KPRMOD,KPRLEN,KPSTRG(10) , KEOFLN , KEOFSTC 1 0) , 
& KE0MC1 ,KEOMC2,KCHARS(4) , KBUFSZ , KBPLOT , KBPSW , 
& KBARM,KBMCDE,KHLENH,KHEADH(10),KHLENT,KHEADT(10),KCONTH, 
& KCONTT,KENDH,KENDT,KNXNOH,KNXMTH(20),KNXNOT,KNXMTT(20), 
& KM ASTH , KM ASTT , KBYTEH , KBYTET , KPACKH , KPACKT , KBLENH , KBLENT , 
& KBLINE, KBLOKH , KECPH , KEOMH, KEOFH, KEOMT, KEOFT 

DIMENSION IFBUF(1),ITBUF(1),ICTL(1 ) 
C * SEE IF PACKING NEEDED, IF NOT BRANCH TO 'EASY WAY' 

IF (KBYTET, EQ, KPACKT) GO TO 70 
C * INITIALIZE VARIABLES 

JOVER=0 

ITNUM=0 

JRP0W=1 

JREGSR=0 

JFCNT=0 

J Of St 1=0 

IF (KPACKT. EQ. 64) JOFSET=32 
i, * uti a But iC rui iniu inn, RtuiSinr, 
10 JFCMT=JFCNT+1 

IF (JFCNT.GT. IFNUM) GO TO 40 
C * GET NEXT 'FROM' BYTE 

JFBYTE=IFBUF(JFCNT)-JOFSET 
C * SHIFT REGISTER BY 'FROM POWER', ADD 'FROM BYTE' 

JREGSR=JREGSR*KPACKT+JFBYTE 

JRPOW=JRPOW*KPACKT 
C * SEE IF ENOUGH IN REGISTER, IF NOT GET ANOTHER 'FROM' BYTE 
20 IF (JRPOW.LT. KBYTET) GO TO 10 

C * DETERMINE 'TO' SHIFT FACTOR 

JSHFT=JRPOW/KBYTET 
C * GET 'TO' CHARACTER FROM REGISTER 

JTBYTE=JREGSR/JSHFT 
C * RESET REGISTER 

torrco- Torrco ttdvtc* tcuct 

JRPOW=JSHFT 
C * PUT 'TO' BYTE INTO SYSTEM INPUT BUFFER OR CONTROL BYTE ARRAY 

IF (ITNUM. LT.KBLENT-4) GO TO 30 
C * CONTROL BYTE ARRAY (OVERFLOW CONDITION) 

J0VER=J0VER+1 

ICTL(JOVER)=JTBYTE 

GO TO 20 
C * SYSTEM INPUT BUFFER 
^0 ITNUM=ITNUM+1 

ITBUF(ITNUM)=JTBYTE 

GO TO 20 
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C * UNPACKING DONE, SHIFT FINAL CHARS INTO CONTROL BYTES 
40 IF (J0VER.E0.4) RETURN 

JCPT=4 

IF (JOVER.EQ.O) GO TO 60 
50 ICTL(JCPT)=ICTL(JOVER) 

JOVER=JOVER-1 

JC PT = JC PT- 1 

IF (JOVER.GT.O) GO TO 50 
60 IF (JCPT .EQ. 0) RETURN 

ICTL(JCPT)=ITBUF(ITNUM) 

JCPT=JCPT-1 

ITHUM=ITNUM-1 

GO TO 60 
C * THE 'EASY WAY* 
70 ITNUM=0 

IF (KEOMH.EQ.O) GO TO 90 

ITNUM = IFNUM-'J 

IF (ITNUM.LE.O) GO TO 90 

DO 80 1=1 , ITNUM 

ITBUF(I)=IFBUF(I) 
80 CONTINUE 
90 DO 100 1=1 ,n 

J=ITNUM+I 

ICTL(I)=IFBUF(J) 
100 CONTINUE 

RETURN 

END 

C 

C SUBROUTINE— CHKSUM — 

C 

SUBROUTINE CHKSUM ( ILEM, IARRAY, ICTL, IPOWER , ICHK1 , ICHK2) 
C * CHKSUM COMPUTES THE CHECKSUM OF THE INPUT ARRAYS 

DIMENSION IARRAYO ) ,ICTL(1 ) 
C * INITIALIZE CHECKSUM ACCUMULATORS 

MAXBYT=IP0WER-1 

ICHK1=MAXBYT 

ICHK2=MAXBYT 
C * DO MAIN ARRAY IF NOT EMPTY 

IF (ILEN.LE.O) GO TO 20 

DO 10 1=1 ,ILEN 

ICHK1=JADRND(ICHK1,IARRAY(I),MAXBYT) 

ICHK2=JADRND(ICHK2,ICHK1,MAXBYT) 
10 CONTINUE 

C * DO FIRST TWO CONTROL BYTES 
20 DO 30 1=1 ,2 

ICHK1=JADRND(ICHK1,ICTL(I) .MAXBYT) 

ICHK2=JADRND(ICHK2,ICHK1,MAXBYT) 
30 CONTINUE 

C * RETURN CHECKSUM CHARACTERS 

ICHK1=MAXBYT-ICHK1-ICHK2 

IF (ICHK1.LT. 1) ICHK1=ICHK1+MAXBYT 

RETURN 

END 
C 

C FUNCTION--JADRND--- 

C 

FUNCTION JADRND ( INUM1 , INUM2, MAXBYT ) 

JTEMP=INUM1+INUM2 

IF (JTEMP.GT. MAXBYT) JTEMP=JTEMP-M§XBYT 

JADRND=JTEMP 

RETURN 

END 
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C 

C SUBROUTINE— RELPAK 

C 

SUBROUTINE RELPAK (RNUM , ILEN, ISTRNG) 
C « RELPAK TRANSLATES A REAL NUMBER INTO H11X FORMAT 
C * THE MANTISSA IS ALWAYS EITHER OR FROM 2»*U TO 2**1 5-1 

DIMENSION ISTRNGO ) 
C * FIRST BRING THE NUMBER INTO THE VALID RANGE 

SNUM=AMIN1( 32767. 0.AMAX1 (-32767.0, RNUM)) 
C * SEE IF IT IS NEAR ZERO 

IF (ABS(SNUM) .LT. .0001) GO TO 10 
C * COMPUTE MANTISSA AND EXPONENT USING LOGS 

JEXP=IFIX(ALOG(ABS(SNUM))/ALOG(2.))-14 

TMftMT-TFTYf QMtlVHUTT r\»Tn»*f. ICYDI U 

U 1 I h ll 1 - 1 1 J. JL \ U ll VI I 1 MV () 1 \(. \ — V !_• d\ 1 / / / 

GO TO 20 
C * NUMBER CONSIDERED TO ZERO 
10 JEXP=0 

JMANT=0 
C * USE INTEGER PACKING ROUTINE TO TRANSLATE 
20 CALL INTPAK (JMANT.L1 , ISTRNGC1 ) ) 

CALL INTPAK (JEXP.L2, ISTRNG(L1+1 )) 

ILEN=L1+L2 

RETURN 

END 
C 

C SUBROUTINE— I NTRAY— 

C 

SUBROUTINE INTRAY (LENINT, INTS, LENADE , IADE ) 
C * INTRAY TRANSLATES AN INTEGER ARRAY INTO 41 1X FORMAT 

DIMENSION INTSC1 ),IADE(1 ) 

CALL INTPAK (LENINT, LENADE, IADE(1 ) ) 

IF (LENINT. LE.O) RETURN 

DO 10 1=1 .LENINT 

CALL INTPAK (INTSCI ) ,LEN1 , IADE(LENADE + 1 ) ) 

LEMADE=LENADE+LEN1 
10 CONTINUE 

RETURN 

run 
l, J ■: u 

C 

C SUBROUTINE— ADERAY— 

C 

SUBROUTINE ADERAY (LEN, IRAY, LENRET, JRAY) 
C * ADERAY TRANSLATES AN ADE ARRAY INTO 41 1X FORMAT 

DIMENSION IRAY(1 ) ,JRAY(1 ) 

CALL INTPAK (LEN, LENRET, JRAY( 1 ) ) 

IF (LEN. LE.O) RETURN 

DO 10 1=1, LEN 

LENRET=LENRET+1 

JRAY(LENRET)=IRAY(I) 
10 CONTINUE 

RETURN 

END 
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r SUBROUTINE— A DER AY — 

C 

SUPROUTINE ADERAY (LE M , IRA Y , LENR ET , JR A Y ) 
C * ADFRAY TRANSLATES AN ADE ARRAY INTO 41 1 X FORMAT 
DIMENSION IRAY(1 ) ,JRAY(1 ) 
CALL IMTPAK (LEN, LENRET, JRAYC 1 ) ) 
IF (LEN.LE.O) RETURN 
DO 10 1=1 , LEN 
LENRET=LENRET+1 
JRAY(LENRET)=IRAY(I) 
10 CONTINUE 
RETURN 
END 
C 

C SUBROUTINE — I NTPAK- — 

C 

SUBROUTINE INTFAK (INT , ILEN, ISTRNG) 
C * INTPAK TRANSLATES AN INTEGER INTO 11 1X FORMAT 

COMMON /COMM/ KOUTPT , KOUTBFC5 1 2) .KINEND, KINPT , KINBUF(51 2 ) , 
& KRESLU,KIGDEL,KPRMOD,KPRLEN,KPSTRG(10),KEOFLN,KEOFST(10), 
& KEOMC1 ,KEOMC2,KCHARS(4) ,KBUFSZ , KBPLOT , KBPSW, 
& KB ARM , KBMODE , KHLENH , KHEADH (10), KHLENT , KHEADT ( 1 ) , KCONTH , 
& KCONTT,KENDH,KENDT,KNXNOH,KNXMTH(20) , KNXNOT, KNXMTT(20) , 
& KM ASTH , KM ASTT , KBYTEH , KBYTET , KPACKH , KPACKT , KBLENH , KBLENT , 
& KBLINE , KBLOKH , KEOPH , KEOMH , KEOFH , KEOMT , KEOFT 
DIMENSION ISTRNGd ) 
C * INTIALIZE LENGTH OF ARRAY RETURNED 

ILEN=0 
C * FIRST BRING NUMBER INTO VALID RANGE 

JINT=MIN0(65535,IABS(INT)) 
C * COMPUTE THE TWO HI-I'S AND THE LO-I 
JHIUJINT/1024+64 
JHI2=MOD(JINT/l6,64)+64 
JLOI=MOD(JINT, 165+32 
IF (INT.GE.O) JL0I=JL0I+16 
C * SEE IF HI-I'S NEEDED 

IF (JHI1.NE.6I4) GO TO 10 
IF (JHI2.NE.64) GO TO 30 
GO TO 50 
C * INSERT FIRST HI-I (EXPANDING TO <ESC><?> IF NEEDED) 
10 IF (JHI1.EQ.127 .AND. KIGDEL.EQ.1) GO TO 20 

ILEN=1 

ISTRNGd ) = JHI1 
GO TO 30 
20 ILEN=2 

ISTRNGd ) = 27 
ISTRNG(2)=63 
C * INSERT SECOND HI-I (EXPANDING TO <ESC><?> IF NEEDED) 
30 IF (JHI2.EQ.127 .AND. KIGDEL.EQ.1) GO TO 40 

ILEN=ILEN+1 
ISTRNG(ILEN)=JHI2 
GO TO 50 
40 ILEN=ILEN+2 

ISTRNG(ILEN-1)=27 
ISTRNG(ILEN)=63 
C » INSERT LO-I 
50 ILEN=ILEN+1 

ISTRNG(ILEN)=JLOI 

RETURN 

END 
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C 

C SUBROUTINE— XYTRN 

C 

SUBROUTINE XYTRN (I X, IY, LEN , ICHARS ) 
C * XYTRN TRANSLATES X-Y COORDINATES INTO OPTIMIZED ADE STRING 
C * IX, IY - X,Y COORDINATES TO BE TRANSLATED 
C * LEN - LENGTH OF OPTIMIZED STRING <=7 

C * ICHARS - OPTIMIZED STRING ARRAY 
C * JCHARS - LOCAL TRANSLATION ARRAY 

C * KCHARS - COMMON ARRAY TO REMEMBER LAST TRANSLATION (EXCEPT LOX) 
C * KRESLU - RESOLUTION OF TRANSLATION [10,12] 
C * KIGDEL - IGNORE DEL (ADE 127) FLAG 

COMMON /COMM/ KOUTPT , K0UTBF(5 1 2 ) ,KINEND, KINPT , KINBUF(5 1 2) ; 
& KRESLIKKIGDEL.KPRMOD.KPRLEN.KPSTRGOO) , KEOFLN , KEOFSTd 0) , 
& KEOMC1 ;KEOMC2|kCHARS(4) ,KBUFSZ , KBPLOT , KBPSW, 
& KBARM,KBMODE,KHLENH,KHEADH(10),KHLENT,KHEADT(10),KCONTH, 
& KCOMTT,KENDH,KENDT,KNXNOH,KNXMTH(20) , KNXNOT, KNXMTT(20) , 
& KM ASTH , KM ASTT , KBYTEH , K3YTET , KPACKH , KPACKT , KBLENH , KBLENT , 
& KBLINE , KBLOKH , KEOPH , KEOMH, KEOFH, KEOMT, KEOFT 

DIMENSION ICHARSd ) ,JCHARS(5) 
^ " rinsi dimnu ouunuiiiHito iniu ihliu rvrtnuc. 

JX=MINOC4095,MAXO(0,IX)) 

JY=MINO(n095,MAXO(0,IY5) 
C * CALCULATE 10-BIT RESOLUTION CHARACTERS 

JCHARSd ) = JY/128+32 

JCHARS (3 )= J Y/4-JY/1 28*32+96 

JCHARS(il) = JX/128+32 

JCHARS (5 ) = JX/M -J X/1 28*32+64 
C * INITIALIZE ARRAY LENGTH 

LEN = 
C * SEE IF HI-Y NEEDED 

IF (JCHARSd ) .EQ.KCHARSd )) GO TO 10 
C * INSERT HI-Y 

LEN=1 

ICHARSd ) = JCHARS(1 ) 

KCHARSd ) = JCHARS(1 ) 
C * SEE IF 12-BIT RESOLUTION 
10 IF (KRESLU. NE . 12) GO TO 20 

C * COMPUTE EXTRA-LO-Y 

JCHARS(2)=(JY-JY/4*4)*4 + (JX-JX/4*lO + 96 
C * SEE IF EXTRA-LO-Y NEEDED 

IF (JCHARS(2).EQ.KCHARS(2)) GO TO 20 
C * INSERT EXTRA-LO-Y 

LEN=LEN+1 

ICHARS(LEN)=JCHARS(2) 

KCHARS(2)=JCHARS(2) 

GO TO 30 



41 14 HOST PROGRAMMER'S @ C-51 



EXAMPLES OF CODE 



C * SEE IF LO-Y NEEDED 

20 IF (JCHARS(3).NE.KCHARS(3)) GO TO 30 

IF (JCHARS(H) .EQ.KCHARS(4)) GO TO 50 
C * INSERT LO-Y 
30 LEN=LEN+1 

ICHARS(LEN)=JCHARS(3) 

KCHARS(3)=JCHARS(3) 
C * EXPAND LO-Y TO <ESC><?> IF NECESSARY 

IF (JCHARS(3).NE. 127 .OR. KIGDEL.EO.O) GO TO 40 

ICHARS(LEN)=27 

LEN=LEN+1 

ICHARS(LEN)=63 
C * SEE IF HI-X NEEDED 
40 IF (JCHARS(4).EO.KCHARS(4)) GO TO 50 

LEN=LEN+1 

ICHARS(LEN)=JCHARS(4) 

KCHARS(4)=JCHARS(4) 
* ALWAYS INCLUDE LO-X 
50 LEN=LEN+1 

ICHARS(LEN)=JCHARS(5) 

RETURN 

END 

C 

C SUBROUTINE--RELUNP--- 

C 

SUBROUTINE RELUNP (ISTRMG , RELPAR ) 
C * RELUNP UNPACKS A REAL-REPORT 

DIMENSION ISTRNGC1) 

CALL INTUMP (ISTRNG, JMANT ) 

CALL INTUNP (ISTRNG(4 ) , JEXP ) 

RELPAR=JMAMT*2*JEXP 

RETURN 

END 
C 

C SUB ROUT INE --INTUNP 

C 

SUBROUTINE INTUNP (ISTRNG, INTPAR) 
C * INTUNP UNPACKS AM INT-REPORT 

DIMENSION ISTRNGd) 

INTPAR=(ISTRNG(1 )-32 ) *1 024+ ( ISTRNG ( 2 )- 32 ) *1 6+M0D( ISTRNG ( 3 ) ,16) 

IF (ISTRNG(3) .LT.48) I NTPAR=-INTPAR 

RETURN 

END 
C 

C SUBRCUTINE--XYUNP 

C 

SUBROUTINE XYUNP (IRAY.IX.IY) 
C * XYUNP UNPACKS TERMINAL-TO-HOST X-Y FORMAT 

DIMENSION IRAYC1 ) 

IX=(IRAY(4)-32)*128+(IRAY(5)-32)*4+IRAY(2)-IRAY(2)/4»4 

IY=(IRAY(1 )-32)*128+(IRAY(3)-32)*4 +(IRAY(2 )-32) /4 

RETURN 

END 
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C 

C SUBROUTINE— KAS2IN — 

C 

SUBROUTINE KAS2IN (LEN , IADE , INT) 
C 

C * TRANSLATES ADE CHARACTERS TO THEIR INTEGER VALUE 
C * LEN - NUMBER OF CONSECUTIVE ADE CHARACTERS 
C * IADE - ADE CHARACTERS TO BE TRANSLATED 
C * INT - INTEGER VALUE AFTER TRANSLATION 
C 

DIMENSION IADEC1 ) 

INT = 

J=LEN+1 

POWER=. 1 
10 J=J-1 

IF (J.LE.O) GO TO 30 

ICHAR=IADE(J) 

IF (ICHAR.EQ.45) GO TO 20 

IF (ICHAR.LT.48 .OR. ICHAR.GT.57) GO TO 10 

POWER=POWER*10. 

INT = INT+(ICHAR-l)8)*IFIX(P0WER) 

GO TO 10 
20 INT=-INT 

30 RETURN 

END 
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C 

C SUBROUTINE— KIN2AS— 

C 

SUBROUTINE KIN2AS (INT , LENLIM , IFILL, LENRET , IADE ) 
C 

C * TRANSLATES INTEGER VALUES INTO ADE CHARACTERS 
C * INT - INTEGER VALUE TO BE TRANSLATED 
C * LENLIM - LIMIT ON NUMBER OF CHARACTERS 
C * IFILL - FILL CHARACTER 

C * >0 RIGHT JUSTIFY, FILL WITH IFILL 

C * =0 LEFT JUSTIFY, NO FILL 

C * <0 LEFT JUSTIFY, FILL WITH ABS(IFILL) 

C * LENRET - NUMBER OF CHARACTERS RETURNED 
C * IADE - ADE CHARACTER ARRAY 
C 

DIMENSION IADE(1 ) ,JADE(16) 
C * SET UP WORKING VARIABLES 

JNT=IABS(INT) 

LENRETrO 
C * TRANSLATE INTEGER INTO WORK ARRAY 
10 LENRET=LENRET+1 

IF (LENRET. GT. LENLIM) GO TO 100 

JADE(LENRET)=JNT-JNT/10*10+4B 

JNT=JNT/10 

IF (JNT.NE.O) GO TO 10 
C * ADD MINUS SIGN IF NEGATIVE 

IF (INT.GE.O) GO TO 20 

LENRET=LENRET+1 

IF (LENRET. GT. LENLIM) GO TO 100 

JADE(LENRET)=15 
C * LEFT JUSTIFIED OR NO FILL 
20 IF (IFILL. GT.O) GO TO 50 

DO 30 1=1 .LENRET 

J=LENRET-I+1 

IADE(I)=JADE(J) 
30 CONTINUE 

IF (IFILL. EC. 0) RETURN 
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C * LEFT JUSTIFIED 

IF (LENRET.EQ.LENLIM) RETURN 

J=LENRET+1 

DO 40 I=J,LEMLIM 

IADE(I)=-IFILL 
40 CONTINUE 

RETURN 
C * RIGHT JUSTIFIED 
50 J=LENLIM-LENRET 

IF (J.EQ.O) GO TO 70 

DO 60 1=1 , J 

IADE(I)=IFILL 
60 CONTINUE 
70 K=J+1 

DO 80 I=K,LENLIM 

J=LENRET-I+K 

IADE(I)=JADE(J) 
80 CONTINUE 

RETURN 
C * OVERFLOW - FILL WITH ASTERISKS 
100 DO 110 1=1 .LENLIM 

IADE(I)=42 
110 CONTINUE 

LEMRET=LENLIM 

RETURN 

END 
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